Ортақ жәшіктер

Ортақ жәшік — белгілі бір иесі жоқ жәшік: оны, мысалы, бір бөлімнің бірнеше қызметкері пайдаланады.

Егер ұйымда домен қосылмаған болса, ортақ жәшіктерді жасау мүмкін болмайды. Доменді қосу жолы

Ортақ жәшікті жасау және реттеу

Ортақ жәшіктермен жасалатын барлық операциялар тек API арқылы қолжетімді.

1-қадам. API интерфейсімен жұмысқа дайындалыңыз

1. API интерфейсімен жұмыс істеу үшін сізге Яндекс OAuth сервисінде қолданбаны жасағаннан кейін алуға болатын OAuth токені қажет болады.

   • Егер сізде әлі OAuth қолданбасы болмаса, оны жасау және токен алу үшін API интерфейсін пайдалану рұқсаты бетіндегі нұсқаулықты пайдаланыңыз. Қолданба жасау кезінде ya360_admin:mail_read_shared_mailbox_inventory және ya360_admin:mail_write_shared_mailbox_inventory рұқсаттарын таңдаңыз.
   • Егер сізде Бизнеске арналған Яндекс 360 API интерфейсімен жұмыс істеуге арналған OAuth қолданбасы бұрыннан бар болса, онда оған қарау және пошта жәшіктерін пайдалану рұқсаттарын реттеулерін өзгерту рұқсатын қосып, нұсқаулық бойынша жаңа OAuth токенін алыңыз.

2. API сұрауларына қажет болатын деректерді жинаңыз.

   1. Ұйым идентификаторын анықтаңыз: admin.yandex.kz бетін ашып, Жалпы реттеулер → Ұйым профилі тармағын таңдаңыз. Идентификатор ұйым атауының астында жазылады.

   2. Рұқсат беру қажет қызметкердің идентификаторын анықтаңыз. Идентификаторды анықтау үшін:

      1. Пайдаланушылар → Қызметкерлер опциясын таңдаңыз.

      2. Қажетті қызметкер жолын тауып, оның атын басыңыз.

      3. Тінтуірдің оң жақ түймесімен қызметкердің логинін басып, сілтеме мекенжайын көшіріп алыңыз.

      4. Мекенжайды кез келген мәтіндік редакторға қойыңыз. Идентификатор — uid= мәнінен кейінгі мекенжай бөлігі. Мысалы,

         https://staff.yandex.ru/bb?org_id=5487632&uid=2260000054273165
         

мекенжайынан ```

     `2260000054273165` идентификаторы жасалады.
     
     {% cut "Қызметкерлердің идентификаторларын API арқылы да анықтауға бола ма?" %}
     
     Әрине. Олардың тізімін қайтаратын сұрау бар. [Құжаттаманы қарау](https://yandex.ru/dev/api360/doc/ru/ref/UserService/UserService_List)
     
     {% endcut %}

2-қадам. Ортақ жәшік жасаңыз

1. Сұрау деректерін қамтитын parameters.json атауы бар файлды дайындаңыз. Мұны кез келген мәтіндік редакторда жасауға болады. Файлда мына форматтағы ортақ жәшіктің параметрлерін көрсетіңіз:

   {
      "email": "{МЕКЕНЖАЙ}",
      "name": "{АТЫ}",
      "description": "{СИПАТТАМАСЫ}"
   }
   

   бұл жердегі {МЕКЕНЖАЙ} — ортақ жәшіктің электрондық пошта мекенжайы; {АТЫ} — ортақ жәшіктің атауы; {СИПАТТАМАСЫ} — ортақ жәшіктің қысқаша сипаттамасы.

2. Ортақ жәшікті жасау сұрауын жасаңыз және жіберіңіз:

   • HTTP әдісі: PUT

   • Сұраудың URL мекенжайы:

     https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/shared
     

     бұл жердегі {ҰЙЫМ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.1 қадамында алынған ұйым идентификаторы.

     Мысал

     https://api360.yandex.net/admin/v1/org/1234567/mailboxes/shared
     

   • Тақырыптар:

     Authorization: OAuth {OAUTH ТОКЕНІ}
     Content-Type: application/json
     

     бұл жердегі {OAUTH ТОКЕНІ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 1-қадамында алынған OAuth токені.

   • Сұрау мәтіні: осы нұсқаулықтың 1-қадамында жасалған parameters.json файлында бар.

   Егер Windows жүйесінде жұмыс істесеңіз, жәшікті табыстауға рұқсат сұрауын келесі түрдегі curl пәрмені арқылы жасауға болады:

   curl -X PUT -H "Authorization: OAuth {OAUTH ТОКЕНІ}" -H "Content-Type: application/json" -d "@parameters.json" https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/shared
   

   бұл жердегі {OAUTH ТОКЕНІ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 1-қадамында алынған OAuth токені; parameters.json — осы нұсқаулықтың 1-қадамында жасалған сұрау мәтіні бар файл; {ҰЙЫМ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.1 қадамында алынған ұйым идентификаторы.

   Мұны қалай жасау керектігін түсінген жоқпын

   1. Топты дайындаңыз: үлгіні кез келген редакторға көшіріп, көрсетілген жерлерге токен мен идентификаторларды қойыңыз.

   2. parameters.json файлы жатқан қалтаны ашыңыз.

   3. Мекенжай жолындағы бос орынды басыңыз.

   4. Ол жерге cmd деп жазып, Enter пернесін басыңыз.

   5. «Пәрмендер жолы» ашылады. Оған дайын пәрменді қойып, Enter пернесін басыңыз.

3. Алынған жауапты талдаңыз: сұрау сәтті орындалған жағдайда, жауапта жасалған ортақ жәшіктің идентификаторы көрсетілген 200 OK күйі болады. Осы идентификаторды сақтаңыз.

3-қадам. Рұқсат беріңіз

Пайдалану рұқсаттарын ұсыну бойынша топтық операцияларға әлі қолдау көрсетілмейді. Бір сұрауда тек бір қызметкерге бір пошта жәшігін пайдалануға рұқсат беруге, өзгертуге немесе жоюға болады. Бірақ сіз осындай сұраулардың бірнешеуін бір уақытта жібере аласыз.

1. Сұрау деректерін қамтитын roles.json атауы бар файлды дайындаңыз. Мұны кез келген мәтіндік редакторда жасауға болады. Файлда пошта жәшігін пайдалану рұқсаты ашылатын қызметкер рөлдерін көрсетіңіз. Рөл сипаттамалары Рөлдер және пайдалану рұқсаты бөлімінде келтірілген.

   Roles.json файлының үлгісі:

   {
      "roles": [
         "shared_mailbox_imap_admin",
         "shared_mailbox_half_sender"
      ]
   }
   

   Поштаны оқуға жауапты болатындықтан, тізімде shared_mailbox_sender немесе shared_mailbox_owner рөлдерінің бірі болуы керек.

2. API интерфейсіне жіберілетін сұрау арқылы қызметкерлерге ортақ жәшікті пайдалануға рұқсат беріңіз:

   • HTTP әдісі: POST

   • Сұраудың URL мекенжайы:

     https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/set/{ЖӘШІК}?actorId={РҰҚСАТЫ БАР ҚЫЗМЕТКЕР}&notify={ХАБАРЛАНДЫРУЛАР ЖІБЕРУ ПАРАМЕТРІ}
     

     бұл жердегі {ҰЙЫМ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.1 қадамында алынған ұйым идентификаторы; {ЖӘШІК} — Жәшік жасау нұсқаулығы арқылы жасалған ортақ жәшіктің идентификаторы; {РҰҚСАТЫ БАР ҚЫЗМЕТКЕР} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.2 қадамында алынған қызметкер идентификаторы; {ХАБАРЛАНДЫРУЛАР ЖІБЕРУ ПАРАМЕТРІ} — жәшікті пайдалану рұқсатының өзгеруі туралы хабарландыру хатын кімге жіберу керектігін анықтайтын параметр. Жарамды мәндер: all, delegates, none. Параметр мәндерінің сипаттамасы Хабарландырулар бөлімінде келтірілген.

     Мысал

     https://api360.yandex.net/admin/v1/org/1234567/mailboxes/mailboxes/set/2260000054273165?actorId=3340000075421587&notify=all
     

   • Тақырыптар:

     Authorization: OAuth {OAUTH ТОКЕНІ}
     Content-Type: application/json
     

     бұл жердегі {OAUTH ТОКЕНІ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 1-қадамында алынған OAuth токені.

   • Сұрау мәтіні: осы нұсқаулықтың 1-қадамында жасалған roles.json файлында орналасқан.

   Егер Windows жүйесінде жұмыс істесеңіз, жәшікті табыстауға рұқсат сұрауын келесі түрдегі curl пәрмені арқылы жасауға болады:

   curl -X POST -H "Authorization: OAuth {OAUTH ТОКЕНІ}" -H "Content-Type: application/json" -d "@roles.json" https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/set/{ЖӘШІК}?actorId={РҰҚСАТЫ БАР ҚЫЗМЕТКЕР}&notify={ХАБАРЛАНДЫРУЛАР ЖІБЕРУ ПАРАМЕТРЛЕРІ}
   

   бұл жердегі {OAUTH ТОКЕНІ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 1-қадамында алынған OAuth токені; roles.json — осы нұсқаулықтың 1-қадамында жасалған сұрау мәтіні бар файл; {ҰЙЫМ} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.1 қадамында алынған ұйым идентификаторы; {ЖӘШІК} — Жәшік жасау нұсқаулығы бойынша жасалған ортақ жәшіктің идентификаторы; {РҰҚСАТЫ БАР ҚЫЗМЕТКЕР} — «API интерфейсімен жұмыс істеуге дайындық» нұсқаулығының 2.2 қадамында алынған қызметкер идентификаторы; {ХАБАРЛАНДЫРУЛАР ЖІБЕРУ ПАРАМЕТРІ} — жәшікті пайдалану рұқсатын өзгерту туралы хабарландыру хатын кімге жіберу керектігін анықтайтын параметр. Жарамды мәндер: all, delegates, none. Параметр мәндерінің сипаттамасы Хабарландырулар бөлімінде келтірілген.

3. Алынған жауапты талдаңыз: сұрау сәтті орындалған жағдайда, жауапта 200 OK күйін және рұқсаттарды өзгерту тапсырмасының идентификаторын аласыз. Алынған идентификаторды сақтаңыз.

4. Рұқсат берілгеніне көз жеткізу үшін, тапсырма идентификаторын қосу арқылы басқа сұрауды орындаңыз:

   curl -X GET -H "Authorization: OAuth {OAUTH ТОКЕНі}" https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/tasks/{ТАПСЫРМА ID}
   

   Жауап ретінде рұқсаттарды өзгерту тапсырмасының күйін аласыз. Егер жауапта complete мәні болса, рұқсаттар сәтті өзгертілді.

4-қадам. Қызметкерлерге поштаны реттеуге көмектесіңіз

[//]: # (ОЖ және ТЖ Пошта веб-сайтында сатылымға шыққан кезде комментарийді жою: Пайдаланушыларға арналған анықтамада ортақ жәшіктермен жұмыс істеу бойынша нұсқаулар бар: — Яндекс Поштаның веб-интерфейсіндегі ортақ жәшіктермен жұмыс істеу жөніндегі нұсқаулық [Поштадағы ортақ пайдалану рұқсаты: ортақ және табысталатын жәшіктер](https://yandex.kz/support/yandex-360/business/mail/kk/shared-access) бөлімінде қамтылған. - )

Электрондық пошта клиенттерін реттеу жөніндегі нұсқаулық Пошта бағдарламаларындағы жәшіктерді ортақ пайдалану мүмкіндігі бөлімінде берілген.

Рұқсатты өшіру

Белгілі бір қызметкердің жәшікті пайдалану рұқсатын өшіру үшін рұқсат беру нұсқаулығындағы тармақтарды орындаңыз, бірақ қолжетімді рөлдер тізімі бар roles.json файлында бос тізімді көрсетіңіз:

   {
      "roles": []
   }

Жәшікті өшіру

Ортақ жәшікті DELETE сұрауы арқылы жоюға болады:

curl -X DELETE -H "Authorization: OAuth {OAUTH ТОКЕНІ}" https://api360.yandex.net/admin/v1/org/{ҰЙЫМ}/mailboxes/shared/{ЖӘШІК}

API құжаттамасы

Рұқсатты басқарудың барлық әдістерінің толық сипаттамасын құжаттамадан таба аласыз.