Kuruluş birimlerini yönetme
Bir Google Workspace hesabının kuruluş ağacı, kullanıcılarınızı mantıksal ve hiyerarşik bir yapı içinde yönetmenizi sağlayan kuruluş birimlerinden oluşur. Bu işlev, Yönetici Konsolu'ndaki "Kuruluşlar ve kullanıcılar" bölümünde bulunan işlevlere benzer. sekmesinden yararlanın. Müşterinin kuruluş birimi hiyerarşisi 35 derinlik düzeyiyle sınırlıdır. Daha fazla bilgi edinmek için Yönetici Yardım Merkezi'ne göz atın.
- Bir Google Workspace hesabının yalnızca bir kuruluş ağacı vardır. Bu hesap ilk yapılandırıldığında hesap düzeyinde bir kuruluş birimi olur. Bu, birincil alanla ilişkilendirilen kuruluştur. Birincil alanla ilgili daha fazla bilgi edinmek için API sınırlarıyla ilgili bilgilere bakın.
- Bir kuruluş biriminin yol adı benzersizdir. Kuruluş biriminin adı, kuruluş hiyerarşisinde benzersiz olmayabilir ancak kuruluş biriminin adı, kardeş kuruluş birimleri arasında benzersizdir. Ayrıca, kuruluş biriminin adı büyük/küçük harfe duyarlı değildir.
- Bir kuruluş birimi, kuruluş hiyerarşisindeki politikaları devralır. Herhangi bir kuruluş
birimi, devralınan politikayı geçersiz kılarak bu ebeveyn devralma zincirini engelleyebilir. İlgili içeriği oluşturmak için kullanılan
bir politikanın diğerine göre önceliği en yakın kuruluş birimi tarafından belirlenir.
Diğer bir deyişle, bir alt kuruluş biriminin politikaları,
ebeveyn birimi sayısında artış oldu.
blockInheritance
ayarı, bir kuruluş birimine ve onun alt kuruluşuna ulaşabilirsiniz.blockInheritance
desteği sonlandırıldı. Politikanın "true" (doğru) değerine ayarlanması artık desteklenmemektedir ve istenmeyen sonuçlara yol açabilir. Örneğin, devralma ve kuruluş yapısındaki kullanıcılar hakkında daha fazla bilgi için yönetim yardım merkezini ziyaret edin. - Kuruluş birimi, hiyerarşik bir ağaçta yukarı veya aşağı taşınabilir. Ayrıca, yeni bir kuruluş doldurulurken ya da bir kullanıcı alt kümesi bir kuruluş biriminden diğerine taşınırken kuruluşun ilişkili kullanıcıları tek tek veya toplu olarak taşınabilir.
- Kuruluş birimi özelliklerinde saklanan veriler sürekli olarak değişebilir. İstekte bulunurken bir varlık için döndürülen özelliklerin, varlığın alındığı anda tutarlı olması garanti edilir. Yani, "kısmi" ifadesini görmezsiniz. güncellemelerine göz atın. Bir alma işlemi birden fazla varlık döndürürse varlıklar arasında tutarlılık garantisi verilmez.Bu durum özellikle yanıt sayfalara ayırmada birden fazla sayfayı kapsıyorsa geçerlidir.
Kuruluş birimi oluşturma
Kuruluş birimi oluşturmak için aşağıdaki POST
isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin.
Kuruluş birimi oluşturan bir yöneticiyseniz my_customer
politikasını kullanın.
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits
Yeniden satış yapılan bir müşteri için kuruluş birimi oluşturan bayiyseniz customerId
öğesini kullanın. customerId
öğesini almak için Kullanıcı alma işlemini kullanın.
POST https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits
Hesabınızın kuruluş yapısını öğrenmek için Yönetici yardım merkezi sayfasına göz atın. İstek ve yanıt özellikleri için API Referansı'na bakın.
JSON isteği
Aşağıdaki JSON bayi örneğinde, sales_support kuruluş birimini oluşturan örnek bir istek gövdesi gösterilmektedir. name
ve parentOrgUnitPath
zorunludur:
POST https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits
{ "name": "sales_support", "description": "The sales support team", "parentOrgUnitPath": "/corp/support", "blockInheritance": false }
JSON yanıtı
Başarılı bir yanıt, HTTP 201 durum kodu döndürür. Yanıt, durum koduyla birlikte yeni gruba ilişkin özellikleri döndürür:
{ "kind": "directory#orgUnit", "name": "sales_support", "description": "The sales support team", "orgUnitPath": "/corp/support/sales_support", "parentOrgUnitPath": "/corp/support", "blockInheritance": false }
Kuruluş birimini güncelleme
Bir kuruluş birimini güncellemek için aşağıdaki PUT
isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. İstek ve yanıt özellikleri için API Referansı'na bakın:
Bir kuruluş birimini güncelleyen bir yöneticiyseniz my_customer
politikasını kullanın.
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath
Yeniden satış yapılan bir müşterinin kuruluş birimini güncelleyen bir bayiyseniz customerId
özelliğini kullanın. customerId
değerini almak için Kullanıcı alma işlemini kullanın.
PUT https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath
JSON isteği
Aşağıdaki örnekte, kuruluş birimi açıklaması güncellendi:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/support/sales_support
{ "description": "The BEST sales support team" }
Güncelleme isteğiyle ilgili notlar:
- İsteğinizde yalnızca güncel bilgileri göndermeniz gerekir. Grubun tüm özelliklerini istekte girmenize gerek yoktur.
- Bir kullanıcı, kullanıcı hesabı oluşturulduğunda belirli bir kuruluş birimine atanmadıysa hesap en üst düzey kuruluş biriminde olur.
- İstekte
parentOrgUnitPath
özelliğini ayarlayarak bir kuruluş birimini hesabınızın kuruluş yapısının başka bir bölümüne taşıyabilirsiniz. Bir kuruluş biriminin taşınması, taşınan kuruluş birimindeki kullanıcıların hizmetleri ve ayarlarını değiştirebilir.
JSON yanıtı
Başarılı bir yanıt, HTTP 201 durum kodu döndürür. Yanıt, durum koduyla birlikte güncellenen kuruluş birimine ilişkin özellikleri döndürür.
{ "kind": "directory#orgUnit", "name": "sales_support", "description": "The BEST sales support team", "orgUnitPath": "/corp/support/sales_support", "parentOrgUnitPath": "/corp/support", "blockInheritance": false }
Bir kullanıcı, kullanıcı hesabı oluşturulduğunda belirli bir kuruluş birimine atanmadıysa hesap en üst düzey kuruluş biriminde olur. Kullanıcının kuruluş birimi, hangi Google Workspace hizmetlerine erişebileceğini belirler. Kullanıcı yeni bir kuruluşa taşınırsa kullanıcının erişimi değişir. Kuruluş yapıları hakkında daha fazla bilgi edinmek için yönetim yardım merkezine göz atın. Bir kullanıcıyı farklı bir kuruluşa taşıma hakkında daha fazla bilgi edinmek için Kullanıcıyı güncelleme başlıklı makaleye göz atın.
Kuruluş birimi alma
Bir kuruluş birimini almak için aşağıdakiGET
isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. orgUnitPath
sorgu dizesi, bu kuruluş biriminin tam yoludur. İstek ve yanıt özellikleri için API Referansı'na bakın:
Kuruluş birimi alan bir yöneticiyseniz my_customer
politikasını kullanın.
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath
Yeniden satış yapılan bir müşteri için kuruluş birimi alan bir bayiyseniz customerId
özelliğini kullanın. customerId
değerini almak için Kullanıcı alma işlemini kullanın.
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath
JSON yanıtı
Aşağıdaki örnekte "ön saflarda satışlar" kuruluş birimi alındı. "Ön saflarda+satış"a dikkat edin. İsteğin URI'sinde HTTP kodlaması:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/corp/sales/frontline+sales
Başarılı bir yanıt, HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte kuruluş biriminin ayarlarını döndürür:
{ "kind": "directory#orgUnit", "name": "frontline sales", "description": "The frontline sales team", "orgUnitPath": "/corp/sales/frontline sales", "parentOrgUnitPath": "/corp/sales", "blockInheritance": false }
Kuruluş birimlerini alma
Bir kuruluş birimindeki tüm alt kuruluş birimlerini, kuruluş biriminin ilk alt kuruluşlarını veya tüm alt kuruluş birimlerini ve tüm alt kuruluş birimlerini almak için aşağıdaki GET
isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. İstek ve yanıt özellikleri için API Referansı'na bakın.
Tüm alt kuruluş birimlerini alan bir hesap yöneticisiyseniz my_customer
politikasını kullanın. Bu örnekte okunabilirlik için satır sonları kullanılmaktadır:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer /orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent
Yeniden satış yapılan bir müşterinin kuruluş birimlerini alan bir bayiyseniz customerId
özelliğini kullanın. customerId
değerini almak için Kullanıcı alma işlemini kullanın:
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId /orgunits?orgUnitPath=full org unit path&type=all or children or all_including_parent
get
sorgu dizesi, all_including_parent
için orgUnitPath
altındaki all
alt kuruluş birimini, orgUnitPath
öğesinin hemen children
alt kuruluş birimini veya tüm alt kuruluş birimlerini ve belirtilen orgUnitPath
değerini döndürür. Varsayılan değer: type=children
.
JSON yanıtı
Örneğin, bu istek /corp
adlı kuruluş biriminden başlayan tüm kuruluş birimlerini döndürür:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits?orgUnitPath=/corp&type=all
Başarılı bir yanıt, HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte hesabın kuruluş birimlerini döndürür:
{ "kind": "directory#orgUnits", "organizationUnits": [ { "kind": "directory#orgUnit", "name": "sales", "description": "The corporate sales team", "orgUnitPath": "/corp/sales", "parentOrgUnitPath": "/corp", "blockInheritance": false }, { "kind": "directory#orgUnit", "name": "frontline sales", "description": "The frontline sales team", "orgUnitPath": "/corp/sales/frontline sales", "parentOrgUnitPath": "/corp/sales", "blockInheritance": false }, { "kind": "directory#orgUnit", "name": "support", "description": "The corporate support team", "orgUnitPath": "/corp/support", "parentOrgUnitPath": "/corp", "blockInheritance": false }, { "kind": "directory#orgUnit", "name": "sales_support", "description": "The BEST support team", "orgUnitPath": "/corp/support/sales_support", "parentOrgUnitPath": "/corp/support", "blockInheritance": false } ] }
Kuruluş birimini silme
Bir kuruluş birimini silmek için aşağıdaki DELETE
isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. customerId
öğesini almak için Kullanıcı alma işlemini kullanın. İstek ve yanıt özellikleri için API Referansı'na bakın:
Bir kuruluş birimini silen hesap yöneticisiyseniz my_customer
politikasını kullanın.
DELETE https://admin.googleapis.com/admin/directory/v1/customer/my_customer/orgunits/orgUnitPath
Yeniden satış yapılan bir müşterinin kuruluş birimini silen bir bayiyseniz customerId
özelliğini kullanın. customerId
değerini almak için Kullanıcı alma işlemini kullanın.
DELETE https://admin.googleapis.com/admin/directory/v1/customer/customerId/orgunits/orgUnitPath
DELETE
isteği 'backend_tests'i siler kuruluş birimi:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/C03az79cb/orgunits/corp/sales/backend_tests
Başarılı bir yanıt, HTTP 200 durum kodu döndürür.
Yalnızca alt kuruluş birimi veya atanmış kullanıcısı olmayan kuruluş birimlerini silebilirsiniz. Silmeden önce kullanıcıları yeniden diğer kuruluş birimlerine atamanız ve alt kuruluş birimlerini kaldırmanız gerekir.