--- metadata: - name: generator content: Diplodoc Platform v5.50.2 - property: og:type content: article - property: article:section content: Kurumsal e-posta - property: og:title content: Genel e-posta kutularının API aracılığıyla yönetimi - property: article:tag content: Teknik talimatlar alternate: - https://yandex.com.tr/support/yandex-360/business/admin/tr/mail/sharing/shared-api.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/yandex-360/business/admin/tr/llms.txt # Genel e-posta kutularının API aracılığıyla yönetimi Paylaşılan posta kutusu, belirli bir sahibi olmayan bir posta kutusudur: örneğin aynı bölümden birkaç çalışan tarafından kullanılır. Bir organizasyonda ilişkilendirilmiş alan adı yoksa, paylaşılan posta kutuları oluşturulamaz. [Bir alan adı nasıl ilişkilendirilir?](https://yandex.com.tr/support/yandex-360/business/admin/tr/domains/index.md) ## Paylaşılan bir posta kutusu oluşturma ve yapılandırma {#process} ### Adım 1. API ile çalışmaya hazırlanın {#prep} 1. API ile çalışmak için Yandex OAuth servisinde bir uygulama oluşturduktan sonra elde edilebilecek [OAuth-belirteci](*p_oauth-token)'ne ihtiyacınız olacaktır. {#prep-step-1} * Henüz bir OAuth uygulamanız yoksa, bir tane oluşturmak ve bir belirteç almak için [API’ye Erişim](https://yandex.ru/dev/api360/doc/access#new) sayfasındaki talimatları kullanın. Uygulamayı oluştururken `ya360_admin:mail_read_shared_mailbox_inventory` ve `ya360_admin:mail_write_shared_mailbox_inventory` yetkilerini seçin. * Yandex 360 API for Business ile çalışmak için zaten bir OAuth uygulamanız varsa, posta kutusu erişim ayarlarını görüntülemek ve değiştirmek için ona yetkiler ekleyin ve ardından [talimatlara](https://yandex.ru/dev/api360/doc/access#add) göre yeni bir OAuth belirteci alın. 2. API istekleri için gerekli olan verileri toplayın. 1. Organizasyonun kimliğini belirleyin: [Kuruluş paneli](https://admin.yandex.com.tr) ’i açın ve **Genel ayarlar** → **Organizasyon profili** ’ni seçin. Kimlik, organizasyonun adının altına yazılacaktır.![](../../_assets/mail/sharing/scr-org-id.png) {#prep-step-2-1} 2. Erişim izni verilmesi gereken çalışanın kimliğini tanımlayın. Kimliği tanımlamak için: {#prep-step-2-2} 1. **Kullanıcılar** → **Çalışanlar** ’ı seçin. 2. İlgili çalışanın satırını bulun ve adına tıklayın. 3. **Çalışan girişi** üzerine sağ tıklayın ve bağlantı adresini kopyalayın.![](../../_assets/mail/sharing/scr-user-id.png) 4. Adresi herhangi bir metin düzenleyicisine yapıştırın. Kimlik – adresin `uid=`’den sonraki kısmıdır. Örneğin, şu adresten: ```html https://staff.yandex.ru/bb?org_id=5487632&uid=2260000054273165 ``` `2260000054273165` kimliği elde edilir. {% cut "Çalışan kimliklerini API üzerinden de tanımlamak mümkün mü?" %} Elbette. Bunların listesini arattıran bir istek vardır. [Belgeleri görüntüleyin](https://yandex.ru/dev/api360/doc/ref/UserService/UserService_List) {% endcut %} ### Adım 2. Paylaşılan bir posta kutusu oluşturun {#create} 1. İstekte kullanılacak verileri içeren ##parameters.json## adlı bir dosya hazırlayın. Bu işlem herhangi bir metin düzenleyicide yapılabilir. Dosyada, oluşturulacak ortak posta kutusunun parametrelerini aşağıdaki formatta belirtin: ```json { "email": "{ADRES}", "name": "{AD}", "description": "{AÇIKLAMA}" } ``` Burada `{ADRES}` ortak posta kutusunun e-posta adresidir; `{AD}` ortak posta kutusunun adıdır; `{AÇIKLAMA}` ortak posta kutusunun kısa bir açıklamasıdır. {#create-step-1} 2. Paylaşılan bir posta kutusu oluşturmak için bir istek oluşturun ve gönderin: - HTTP yöntemi: `PUT` - İstek URL’si: ```html https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/shared ``` Burada `{ORGANİZASYON}` – “API ile Çalışmaya Hazırlık” talimatının [2.1 adımında](#prep-step-2-1) elde edilen organizasyon kimliğidir. {% cut "Örnek" %} ```html https://api360.yandex.net/admin/v1/org/1234567/mailboxes/shared ``` {% endcut %} - Başlıklar: ```html Authorization: OAuth {OAUTH-BELİRTEÇ} Content-Type: application/json ``` Burada `{OAUTH- BELİRTEÇ}` – “API ile Çalışmaya Hazırlık” talimatının [1 adımında](#prep-step-1) alınan OAuth belirtecidir. - İstek metni: Bu talimatların [1 adımında](#create-step-1) oluşturulan## parameters.json## dosyasında yer alır. Windows üzerinde çalışıyorsanız, aşağıdaki şekildeki bir `curl` komutunu kullanarak posta kutusu temsilci atama için bir izin isteği gönderebilirsiniz: ```html curl -X PUT -H "Authorization: OAuth {OAUTH-BELİRTEÇ}" -H "Content-Type: application/json" -d "@parameters.json" https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/delegated ``` Burada `{OAUTH-BELİRTEÇ}` – “API ile Çalışmaya Hazırlık” talimatının [1 adımında](#prep-step-1) elde edilen OAuth belirtecidir; `parameters.json` – bu talimatın [1 adımında](#create-step-1) oluşturulan istek metni dosyasıdır; `{ORGANİZASYON}` – “API ile Çalışmaya Hazırlık” talimatının [2.1 adımında](#prep-step-2-1) elde edilen organizasyon kimliğidir. {% cut "Bunun nasıl yapılacağını anlamıyorum" %} 1. Komutu hazırlayın: Örneği herhangi bir düzenleyiciye kopyalayın, belirteci ve kimlikleri belirtilen yerlere yapıştırın. 2. ##parameters.json## dosyasının bulunduğu klasörü açın. 3. Adres satırındaki boş alana tıklayın. 4. Buraya `cmd` yazın ve Enter tuşuna basın. 5. “Komut Satırı” penceresi açılacaktır. Hazır komutu içine yapıştırın ve Enter tuşuna basın. {% endcut %} 3. Alınan yanıtı analiz edin: İsteğin başarılı olması halinde, yanıtta oluşturulan paylaşılan posta kutusunun kimliğini gösteren `200 OK` durumunu alacaksınız. Elde edilen kimliği kaydedin. ### Adım 3. Erişim sağlayın {#access} Grup işlemleri erişim verme konusunda henüz desteklenmemektedir. İstek başına yalnızca bir çalışan için bir posta kutusuna erişim hakkı verebilir, değiştirebilir veya silebilirsiniz. Ancak aynı anda birden fazla istekte bulunabilirsiniz. 1. İstekte kullanılacak verileri içeren ##roles.json## adlı bir dosya hazırlayın. Bu işlem herhangi bir metin düzenleyicide yapılabilir. Dosyada, posta kutusuna erişim yetkisi verilen çalışanın rollerini belirtin. Rollerin açıklaması [Roller ve erişim yetkileri](https://yandex.com.tr/support/yandex-360/business/admin/tr/mail/sharing/index.md#access-rules) bölümünde yer almaktadır. Örnek dosya ##roles.json##: ```json { "roles": [ "shared_mailbox_imap_admin", "shared_mailbox_half_sender" ] } ``` `shared_mailbox_sender` veya `shared_mailbox_owner` rollerinden biri listede bulunmalıdır, çünkü bunlar e-postaları okumaktan sorumludur. 2. Bir API isteği ile, çalışanlara, paylaşılan bir posta kutusuna erişim yetkisi verin: - HTTP yöntemi: `POST` - İstek URL’si: ```html https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/set/{ЯЩИК}?actorId={ERİŞİM HAKKI OLAN ÇALIŞAN}¬ify={BİLDİRİM GÖNDERME PARAMETRESİ} ``` Burada `{ORGANISATION}` – “API ile Çalışmaya Hazırlık” talimatının [2.1 adımında elde edilen](#prep-step-2-1) organizasyonun kimliğidir; `{POSTA KUTUSU}` – [Posta Kutusu Oluşturma](#create) talimatı ile oluşturulan paylaşılan posta kutusunun kimliğidir; `{ERİŞİMİ OLAN ÇALIŞAN}` – “API ile Çalışmaya Hazırlık” talimatının [2.2 adımında](#prep-step-2-2) elde edilen, posta kutusuna erişim yetkisi verilmesi gereken çalışanın kimliğidir; `{BİLDİRİM GÖNDERME PARAMETRESİ}` – posta kutusuna erişim yetkilerinin değiştirilmesi hakkında kime bildirim e-postası gönderilmesi gerektiğini tanımlayan parametredir. Olası değerler: `all`, `delegates`, `none`. Parametre değerlerinin açıklaması [Bildirimler](https://yandex.com.tr/support/yandex-360/business/admin/tr/mail/sharing/index.md#notifies) bölümünde yer almaktadır. {% cut "Örnek" %} ```html https://api360.yandex.net/admin/v1/org/1234567/mailboxes/mailboxes/set/2260000054273165?actorId=3340000075421587¬ify=all ``` {% endcut %} - Başlıklar: ```html Authorization: OAuth {OAUTH-BELİRTEÇ} Content-Type: application/json ``` Burada `{OAUTH- BELİRTEÇ}` – “API ile Çalışmaya Hazırlık” talimatının [1 adımında](#prep-step-1) alınan OAuth belirtecidir. - İstek metni: Bu talimatların [1 adımında](#access-step-1) oluşturulan## roles.json## dosyasında yer alır. Windows üzerinde çalışıyorsanız, aşağıdaki şekildeki bir `curl` komutunu kullanarak posta kutusu temsilci atama için bir izin isteği gönderebilirsiniz: ```html curl -X POST -H "Authorization: OAuth {OAUTH BELİRTECİ}" -H "Content-Type: application/json" -d "@roles.json" https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/set/{SAHİBİ}?actorId={ERİŞİM HAKKI OLAN ÇALIŞAN}¬ify={BİLDİRİM GÖNDERME PARAMETRESİ} ``` Burada `{OAUTH-BELİRTEÇ}` – “API ile Çalışmaya Hazırlık” talimatının [1 adımında](#prep-step-1) elde edilen OAuth belirtecidir; `roles.json` bu talimatın [1 adımında](#access-step-1) oluşturulan istek metni dosyasıdır; `{ORGANİZASYON}` – “API ile Çalışmaya hazırlık” talimatının [2.1 adımında](#prep-step-2-1) elde edilen organizasyon kimliğidir; `{POSTA KUTUSU}` – [Posta Kutusu Oluşturma](#create) talimatına göre oluşturulan, paylaşılan posta kutusunun kimliğidir; `{ERİŞİMİ OLAN ÇALIŞAN}` – “API ile Çalışmaya Hazırlık” talimatının [2.2 adımında](#prep-step-2-2) elde edilen, posta kutusuna erişim yetkisi verilmesi gereken çalışanın kimliğidir; `{BİLDİRİM GÖNDERME PARAMETRESİ}` – posta kutusuna erişim yetkilerinin değiştirilmesiyle ilgili bildirim e-postasının kime gönderilmesi gerektiğini tanımlayan parametredir. Olası değerler: `all`, `delegates`, `none`. Parametre değerlerinin açıklaması [Bildirimler](https://yandex.com.tr/support/yandex-360/business/admin/tr/mail/sharing/index.md#notifies) bölümünde yer almaktadır. 3. Alınan yanıtı analiz edin: İsteğin başarılı olması durumunda, yanıtta `200 OK` durumunu ve yetki değişikliği için görev kimliğini alırsınız. Elde edilen kimliği kaydedin. 4. Erişim yetkisi verildiğinden emin olmak için, görev kimliğini değiştirerek başka bir istek gönderin: ```html curl -X GET -H "Yetkilendirme: OAuth {OAUTH-BELİRTEÇ}" https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/tasks/{ID TASKS} ``` Yanıt olarak, yetkileri değiştirme görevinin durumunu alacaksınız. Yanıt `complete` değeriyle gelirse yetkiler başarıyla değiştirilmiş demektir. ### Adım 4 Çalışanlara e-posta kurulumu konusunda yardımcı olun {#user-instruction} [//]: # (Yandex Ads ve Yandex Direct prod ortamına geçtiğinde yorumla: Ortak posta kutularıyla çalışma talimatları kullanıcılara yönelik Yardım bölümünde mevcuttur: – Yandex Mail web arayüzünde ortak posta kutularıyla çalışma talimatı şu bölümde yer almaktadır \[Yandex Mail’e ortak erişim: Ortak ve yetkilendirilmiş posta kutuları\]\(https://yandex.com.tr/support/yandex-360/business/mail/shared-access\). - ) E-posta istemcilerinin ayarlanmasıyla ilgili talimatlar [E-posta programlarında posta kutularının paylaşılması](https://yandex.com.tr/support/yandex-360/business/mail/mail-clients/shared-mailboxes) bölümünde yer almaktadır. ## Erişimin devre dışı bırakılması {#revoke-access} Belirli bir çalışanın posta kutusuna erişimini devre dışı bırakmak için, erişim verme talimatlarının adımlarını uygulayın, sadece mevcut rollerin listesini içeren ##roles.json## dosyasında aşağıdaki şekilde boş bir liste belirtin: ```json { "roles": [] } ``` ## Posta kutusu silme {#delete-mailbox} Bir DELETE isteği kullanarak paylaşılan bir posta kutusunu silebilirsiniz: ```html curl -X DELETE -H "Authorization: OAuth {OAUTH-BELİRTEÇ}" https://api360.yandex.net/admin/v1/org/{ORGANİZASYON}/mailboxes/shared/{POSTA KUTUSU} ``` ## API belgeleri {#doc} Erişim yönetimine ilişkin tüm yöntemlerin tam açıklamasını [belgelerde](https://yandex.ru/dev/api360/doc/ref/MailboxService/) bulabilirsiniz.
{% cut "Destek Ekibi'ne yaz" %}
{% endcut %}
[*p_api]: API – Yandex 360 servislerini yönetmek üzere öncelikle süreçleri otomatikleştirmek için tasarlanmış özel bir mekanizmadır. API ile çalışmanın iki yolu vardır: Özel bir uygulama oluşturarak (bunu bir geliştirici yapabilir) veya bilgisayarınızın komut satırını kullanarak. [Geliştiriciler için tüm belgeler](https://yandex.ru/dev/api360/doc/). [*p_oauth-token]: Belirli bir kullanıcı adına verilere erişime izin veren özel kod. [*p_post-request]: Sunucuda yeni bir kaynak oluşturmak için API isteği. Yeni bir nesne oluşturmak veya bir eylem gerçekleştirmek üzere sunucuya veri göndermek için kullanılır. [*p_delete-request]: Sunucudaki mevcut bir kaynağı silmek için API isteği. Bir kaynağı kimliğine veya diğer benzersiz kimliğine göre silmek için kullanılır.