--- metadata: - name: generator content: Diplodoc Platform v5.50.3 alternate: - https://yandex.uz/support/yandex-360/business/admin/ru/mail/sharing/shared-api.md - https://yandex.uz/support/yandex-360/business/admin/uz/mail/sharing/shared-api.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.uz/support/yandex-360/business/admin/uz/llms.txt # Umumiy qutilar Umumiy quti — aniq egasi bo‘lmagan quti: undan bir nechta xodimlar foydalanadi, masalan, bitta bo‘limdan. Agar tashkilot domeni ulanmagan bo‘lsa, umumiy qutilarni yaratib bo‘lmaydi. [Domenni qanday ulash mumkin](https://yandex.uz/support/yandex-360/business/admin/uz/domains/index.md) ## Umumiy qutini yaratish va sozlash {#process} Umumiy qutilar bilan barcha amallar hozircha faqat [API](*p_api) orqali mavjud. ### 1-qadam. API bilan ishlashga tayyorlaning {#prep} 1. API bilan ishlash uchun sizga Yandex OAuth xizmatida ilovani yaratgandan keyin olishingiz mumkin bo‘lgan [OAuth-token](*p_oauth-token) kerak bo‘ladi. {#prep-step-1} * Hali sizda OAuth-ilova mavjud bo‘lmasa, uni yaratish va token olish uchun [API ruxsat](https://yandex.ru/dev/api360/doc/ru/access#new) sahifasidagi ko‘rsatmalardan foydalaning. Ilovani yaratishda `ya360_admin:mail_read_shared_mailbox_inventory` va `ya360_admin:mail_write_shared_mailbox_inventory` huquqlarini tanlang. * Agar sizda biznes uchun API Yandex 360 bilan ishlash uchun OAuth-ilova mavjud bo‘lsa, unga pochta qutilariga ruxsat sozlamalari ko‘rish va o‘zgartirish huquqini qo‘shing, keyin esa [ko‘rsatmalar](https://yandex.ru/dev/api360/doc/ru/access#add) bo‘yicha yangi OAuth-token oling. 2. API-so‘rovlari uchun talab qilinadigan ma’lumotlarni to‘plang. 1. Tashkilot identifikatorini aniqlang: [admin.yandex.ru](https://admin.yandex.uz) sahifasini oching va **Umumiy sozlamalar** → **Tashkilot profili** bandini tanlang. Identifikator tashkilot nomi ostida yoziladi.![](../../_assets/mail/sharing/scr-org-id.png) {#prep-step-2-1} 2. Ruxsat berilishi kerak bo‘lgan xodimning identifikatorini aniqlang. Identifikatorni aniqlash uchun: {#prep-step-2-2} 1. **Foydalanuvchilar** → **Xodimlar** bandini tanlang. 2. Kerakli xodimning satrini toping va uning ismini bosing. 3. O‘ng tugma bilan **xodim login** ustiga bosing va havola manzilini nusxalang.![](../../_assets/mail/sharing/scr-user-id.png) 4. Istalgan matn muharririga manzil kiriting. Identifikator — bu `uid=` dan keyingi manzilning qismi. Masalan, manzildan ```html https://staff.yandex.ru/bb?org_id=5487632&uid=2260000054273165 ``` `2260000054273165` identifikatori olinadi. {% cut "Xodimlarning identifikatorlarini API orqali ham aniqlash mumkinmi?" %} Albatta. Ularning ro‘yxatini qaytaradigan so‘rov mavjud. [Hujjatchilikni ko‘rish](https://yandex.ru/dev/api360/doc/ru/ref/UserService/UserService_List) {% endcut %} ### 2-qadam. Umumiy qutini yarating {#create} 1. So‘rov uchun ma’lumotlarni o‘z ichiga olgan ##parameters.json## nomidagi faylni tayyorlang. Buni har qanday matn muharririda qilish mumkin. Faylda yaratilayotgan umumiy qutining parametrlarini quyidagi shaklda ko‘rsating: ```json { "email": "{MANZIL}", "name": "{ISM}", "description": "{TAVSIF}" } ``` bunda `{MANZIL}` — umumiy qutining elektron pochta manzili; `{ISM}` — umumiy qutining nomi; `{TAVSIF}` — umumiy qutining qisqacha tavsifi. {#create-step-1} 2. Umumiy qutini yaratish uchun so‘rovni shakllantiring va yuboring: - HTTP-usul: `PUT` - So‘rov URL: ```html https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/shared ``` bunda `{TASHKILOT}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.1-qadamida](#prep-step-2-1) olingan tashkilotning identifikatori. {% cut "Namuna" %} ```html https://api360.yandex.net/admin/v1/org/1234567/mailboxes/shared ``` {% endcut %} - Sarlavhalar: ```html Authorization: OAuth {OAUTH-TOKEN} Content-Type: application/json ``` bunda `{OAUTH-TOKEN}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [1-qadamida](#prep-step-1) olingan OAuth-token. - So‘rov tanasi: ##parameters.json## faylda mavjud, u bu ko‘rsatmaning [1-qadamida](#create-step-1) yaratilgan. Windowsda ishlasangiz, shunday turdagi `curl` buyrug‘i yordamida qutiga vakolat berishga ruxsat berish uchun so‘rov yuborish mumkin: ```html curl -X PUT -H "Authorization: OAuth {OAUTH-TOKEN}" -H "Content-Type: application/json" -d "@parameters.json" https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/shared ``` bunda `{OAUTH-TOKEN}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [1-qadamida](#prep-step-1) olingan OAuth-token; `parameters.json` — bu ko‘rsatmaning [1-qadamida](#create-step-1) yaratilgan fayl bilan so‘rov tanasi; `{TASHKILOT}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.1-qadamida](#prep-step-2-1) olingan tashkilotning identifikatori. {% cut "Buni qanday qilishni tushunmayapman" %} 1. Buyruqni tayyorlang: namunani istalgan muharrirga nusxalang, ko‘rsatilgan joylarga token va identifikatorlarni qo‘ying. 2. ##parameters.json## fayl joylashgan jildni oching. 3. Manzil qatoridagi bo‘sh joyni bosing. 4. U yerga `cmd` yozing va Enter tugmasini bosing. 5. “Buyruq qatori” oynasi ochiladi. Unga tayyor buyruqni qo‘ying va Enter tugmasini bosing. {% endcut %} 3. Olingan javobni tahlil qiling: so‘rov muvaffaqiyatli bajarilgan holatda, javobda yaratilgan umumiy qutining identifikatori ko‘rsatilgan `200 OK` holatini olasiz. Bu identifikatorni saqlang. ### 3-qadam. Kirishga ruxsat bering {#access} Guruhli amallarga ruxsat berish hali qo‘llab-quvvatlanmaydi. Bitta so‘rovda faqat bitta xodimga bitta pochta qutisiga kirish huquqini berish, o‘zgartirish yoki o‘chirish mumkin. Ammo bir vaqtning o‘zida bunday so‘rovlardan bir nechtasini yuborishingiz mumkin. 1. So‘rov uchun ma’lumotlarni o‘z ichiga olgan ##roles.json## nomidagi faylni tayyorlang. Buni har qanday matn muharririda qilish mumkin. Faylda qutiga kirish huquqi berilgan xodimning rollarini ko‘rsating. Rollarning tavsifi [Rollar va kirish huquqlari](https://yandex.uz/support/yandex-360/business/admin/uz/mail/sharing/index.md#access-rules) bo‘limida keltirilgan. Fayl namunasi ##roles.json##: ```json { "roles": [ "shared_mailbox_imap_admin", "shared_mailbox_half_sender" ] } ``` Ro‘yxatda parollar biri `shared_mailbox_sender` yoki `shared_mailbox_owner` qatnashishi kerak, chunki ular pochtani o‘qishga javob beradi. 2. APIga so‘rov yordamida xodimlarga umumiy qutiga kirish huquqini taqdim eting: - HTTP-usul: `POST` - So‘rov URL: ```html https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/set/{QUTI}?actorId={RUXSATI BOR XODIM}¬ify={BILDIRISHNOMALARNI YUBORISH PARAMETRI} ``` bunda `{TASHKILOT}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.1-qadamida](#prep-step-2-1) olingan tashkilotning identifikatori; `{QUTI}` — [Qutini yaratish](#create) ko‘rsatmasi bo‘yicha yaratilgan umumiy qutining identifikatori; `{RUXSATI BOR XODIM}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.2-qadamida](#prep-step-2-2) olingan qutiga rusxat berish kerak bo‘lgan xodimning identifikatori; `{BILDIRISHNOMALARNI YUBORISH PARAMETRI}` — qutiga kirish huquqini o‘zgartirish haqida kimga bildirishnoma yuborish kerakligini aniqlaydigan parametr. Ehtimoliy qiymatlar: `all`, `delegates`, `none`. Parametr qiymatlari tavsifi [Bildirishnomalar](https://yandex.uz/support/yandex-360/business/admin/uz/mail/sharing/index.md#notifies) bo‘limida keltirilgan. {% cut "Namuna" %} ```html https://api360.yandex.net/admin/v1/org/1234567/mailboxes/mailboxes/set/2260000054273165?actorId=3340000075421587¬ify=all ``` {% endcut %} - Sarlavhalar: ```html Authorization: OAuth {OAUTH-TOKEN} Content-Type: application/json ``` bunda `{OAUTH-TOKEN}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [1-qadamida](#prep-step-1) olingan OAuth-token. - So‘rov tanasi: ##roles.json## faylda mavjud, u bu ko‘rsatmaning [1-qadamida](#access-step-1) yaratilgan. Windowsda ishlasangiz, shunday turdagi `curl` buyrug‘i yordamida qutiga vakolat berishga ruxsat berish uchun so‘rov yuborish mumkin: ```html curl -X POST -H "Authorization: OAuth {OAUTH-TOKEN}" -H "Content-Type: application/json" -d "@roles.json" https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/set/{QUTI}?actorId={RUXSATI BOR XODIM}¬ify={BILDIRISHNOMALARNI YUBORISH PARAMETRI} ``` bunda `{OAUTH-TOKEN}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [1-qadamida](#prep-step-1) olingan OAuth-token; `roles.json` — bu ko‘rsatmaning [1-qadamida](#access-step-1) yaratilgan fayl bilan so‘rov tanasi; `{TASHKILOT}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.1-qadamida](#prep-step-2-1) olingan tashkilotning identifikatori; `{QUTI}` — [Qutini yaratish](#create) ko‘rsatmasi bo‘yicha yaratilgan umumiy qutining identifikatori; `{RUXSATI BOR XODIM}` — “API bilan ishlashga tayyorgarlik” ko‘rsatmasining [2.2-qadamida](#prep-step-2-2) olingan qutiga rusxat berish kerak bo‘lgan xodimning identifikatori; `{BILDIRISHNOMALARNI YUBORISH PARAMETRI}` — qutiga kirish huquqini o‘zgartirish haqida kimga bildirishnoma yuborish kerakligini aniqlaydigan parametr. Ehtimoliy qiymatlar: `all`, `delegates`, `none`. Parametr qiymatlari tavsifi [Bildirishnomalar](https://yandex.uz/support/yandex-360/business/admin/uz/mail/sharing/index.md#notifies) bo‘limida keltirilgan. 3. Olingan javobni tahlil qiling: so‘rov muvaffaqiyatli bajarilgan holatda, javobda `200 OK` holatini va huquqlarni o‘zgartirish vazifasi identifikatorini olasiz. Olingan identifikatorni saqlang. 4. Ruxsat berilganiga ishonch hosil qilish uchun unga vazifa identifikatorini kiritish orqali yana bir so‘rovni amalga oshiring: ```html curl -X GET -H "Authorization: OAuth {OAUTH-TOKEN}" https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/tasks/{VAZIFA ID} ``` Javobda huquqni o‘zgartirish vazifasi holatini olasiz. Ruxsat muvaffaqiyatli o‘zgartirildi, agar javobda `complete` qiymati kelgan bo‘lsa. ### 4-qadam. Pochtani sozlashda xodimlarga yordam bering {#user-instruction} [//]: # (Pochtaning veb-saytida OYA va DYA ishga tushirilganda, ushbu qismni izohdan chiqaring: Umumiy qutilar bilan ishlash bo‘yicha ko‘rsatmalar Foydalanuvchilar uchun ma’lumotnomada mavjud: — Yandex Pochta veb-interfeysida umumiy qutilar bilan ishlash bo‘yicha ko‘rsatmalar \[Pochtaga umumiy kirish: umumiy va vakolat berilgan qutilar\]\(https://yandex.uz/support/yandex-360/business/mail/uz/shared-access\) bo‘limida keltirilgan. - ) Pochta mijozlarini sozlash bo‘yicha ko‘rsatmalar [Pochta dasturlarida pochta qutilariga umumiy ruxsat](https://yandex.uz/support/yandex-360/business/mail/uz/mail-clients/shared-mailboxes) bo‘limida keltirilgan. ## Ruxsatni o‘chirish {#revoke-access} Muayyan xodimning qutiga kirishini o‘chirish uchun ruxsat berish bo‘yicha ko‘rsatmaning bandlarini bajaring, faqat ##roles.json## mavjud rollar ro‘yxati faylida bo‘sh ro‘yxatni ko‘rsating: ```json { "roles": [] } ``` ## Qutini o‘chirish {#delete-mailbox} DELETE-so‘rovi yordamida umumiy qutini o‘chirish mumkin: ```html curl -X DELETE -H "Authorization: OAuth {OAUTH-TOKEN}" https://api360.yandex.net/admin/v1/org/{TASHKILOT}/mailboxes/shared/{QUTI} ``` ## API hujjatlari {#doc} Barcha ruxsatni boshqarish usullarining to‘liq tavsifini [hujjatlar](https://yandex.ru/dev/api360/doc/ru/ref/MailboxService/) bo‘limidan topasiz.
{% cut "Yordam xizmatiga yozish" %}
{% endcut %}
[*p_api]: API — Yandex 360 xizmatlarini boshqarishning maxsus mexanizmi bo‘lib, asosan jarayonlarni avtomatlashtirish uchun mo‘ljallangan. API bilan ishlashning ikki usuli mavjud: maxsus ilova yaratish (buni dasturchi amalga oshirishi mumkin) yoki kompyuterning buyruq satridan foydalanish. [Dasturchilar uchun to‘liq hujjatlar](https://yandex.ru/dev/api360/doc/ru/). [*p_oauth-token]: Ma’lumotlarga aniq foydalanuvchi nomidan ruxsat beradigan maxsus kod. [*p_post-request]: Serverda yangi resurs yaratish uchun API-so‘rov. Yangi obyektni yaratish yoki biror harakatni bajarish uchun ma’lumotlarni serverga yuborish uchun foydalaniladi. [*p_delete-request]: Serverda mavjud resursni o‘chirish uchun API-so‘rov. Resursni uning identifikatori yoki boshqa unikal identifikator bo‘yicha o‘chirish uchun foydalaniladi.