Kuruluşunuz büyüdükçe konumlarınızın ve izinlerinizin yönetimi sizi bunaltabilir. Bu kılavuzda, birden fazla konumu yönetmeye yönelik en iyi uygulamalar ayrıntılı bir şekilde açıklanmakta ve aşağıdaki hesap türleri açıklanmaktadır:
Hesap türleri
Her hesap türü, konumların yönetiminde bir role sahiptir. Kişisel hesap, bir kuruluş hesabını yönetebilir ve ardından bu kuruluştaki kullanıcı grupları ve konum grupları için izinler alabilir. Kişisel hesap, ilişkili konum grupları aracılığıyla konumları ve girişleri yönetebilir.
Kişisel hesap
Google Hesabı oluşturduğunuzda kişisel bir hesap otomatik olarak kullanılabilir hale gelir. Kişisel hesaplar, girişlerin sahibi ve yöneticisi olabilir.
Kurumsal hesap
Kuruluş hesabı, ajansınızı temsil eden temel hesaptır. Konum grubunuz ve kullanıcı gruplarınız bunlara kaydedilir ve bir kuruluşun tüm üyeleri bunlara erişebilir. Konumlar, birden fazla kuruluşun parçası olabilir.
My Business Account Management API ile kişisel hesapları, kurumsal hesabı yönetmeye veya sahip olmaya davet etmek için accounts.admins.create yöntemini kullanabilirsiniz.
Konum grubu hesabı
Konum grubu, tek tek konumlardan oluşan bir grubu yönetmek için kullanılır. Birden fazla konumla ilgili toplu görevler yapmak için bir yer grubu kullanabilirsiniz. Bir konum grubuna kişisel hesaplar ve kullanıcı grupları eklediğinizde bunlar konum grubunun izinlerini devralır.
Ayrıca, konumları zincire, bölgeye veya kategoriye göre kategorilere ayırmak için yer grupları da oluşturabilirsiniz. Konumlar aynı anda birden çok yer grubunda olabilir.
My Business Account Management API ile konum grupları oluşturmak ve bir konum grubuna konum aktarmak için accounts.create yöntemini kullanabilirsiniz. Kişisel hesapları, API ile konum gruplarını yönetmeye davet edebilirsiniz. Kullanıcı grupları, web arayüzünden konum gruplarına doğrudan eklenebilir.
Kullanıcı grubu hesabı
İzinleri geniş ölçekte yönetmek için bir kullanıcı grubu kullanın. Bir kullanıcı grubuna kişisel hesaplar ekleyebilirsiniz. Ardından, kullanıcı grubu yönetimine kuruluştaki birden çok konum grubu için erişim izni verebilirsiniz. Artık kullanıcı grubundaki tüm kişisel hesaplar, konum gruplarının altındaki konumlarda yönetim işlemleri gerçekleştirebilir.
Örneğin, operasyon ekibine yeni bir üye katıldığında bu üyeyi doğrudan kullanıcı grubuna ekleyebilirsiniz. Böylece üye, akranlarının erişebildiği tüm konumlara hemen erişebilir. Kullanıcılara her bir konuma erişim izni vermek daha uzun sürer ve bu şekilde yönetmek daha zordur.
My Business Account Management API ile kullanıcı grupları oluşturmak için accounts.create yöntemini kullanabilirsiniz. API'yi kullanarak kişisel hesapları, hesaplar ve konumlar yöneticilerini yönetmeye davet edebilirsiniz.
Tüm hesapların listesini çağırmak için API'yi kullanma
Erişiminizin olduğu tüm hesapları ve ilişkili hesap türlerini listelemek için OAuth kimlik bilgilerinizle accounts.list yöntemini çağırın. Yanıtta, tüm hesapların, name alanında bulunan hesap kimliklerinin ve hesap türlerinin listesi yer alır.
İstek
Aşağıda bir accounts.list isteği örneği verilmiştir:
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Yanıt
Aşağıda bir accounts.list yanıtı örneği verilmiştir:
{
"accounts": [
{
"name": "accounts/{accountId}",
"accountName": "John Doe",
"type": "PERSONAL",
"state": {
"status": "UNVERIFIED"
},
"profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
},
{
"name": "accounts/{accountId}",
"accountName": "John Doe’s Location Group",
"type": "LOCATION_GROUP",
"role": "OWNER",
"state": {
"status": "UNVERIFIED"
},
"accountNumber": "{accountNumber}",
"permissionLevel": "OWNER_LEVEL"
}
]
}
Bu kılavuzda ayrıntılı olarak açıklanan tüm hesap türleri, accounts.list isteğinize verilen yanıta dahil edilebilir. Hesap listesini inceleyin ve yönetmek istediğiniz konumlara erişimi olan belirli hesabı belirleyin. Ardından, belirli bir hesabın erişim sahibi olduğu konumların listesini almak için ilgili hesabın ad alanıyla accounts.locations.list yöntemini çağırın.
Örneğin, "Can Doğru'nun Konum Grubu"na ait tüm konumları almak istiyorsanız aşağıdaki isteği yapın:
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
Yanıt, kullanıcının erişebildiği konumların bir listesini aşağıdaki şekilde döndürür:
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Konum yönetimi şeması
Aşağıdaki diyagramda aşağıdakiler gösterilmektedir:
- Kuruluşlar birden fazla kullanıcı grubu içerebilir.
- Kullanıcı grupları birden fazla yer grubunu yönetebilir.
- Yer grupları birden fazla konum içerebilir.
- Konumlar, kuruluşlar arasında birden çok konum grubunu kapsayabilir.
