Yerleri geniş ölçekte yönetme

Kuruluşunuz büyüdükçe konumlarınızın ve izinlerinizin yönetimi sizi bunaltabilir. Bu kılavuzda, birden fazla konumu yönetmeyle ilgili en iyi uygulamalar ayrıntılı olarak açıklanmakta ve aşağıdaki hesap türleri açıklanmaktadır:

Hesap türleri

Her hesap türünün, konumların yönetiminde bir rolü vardır. Kişisel hesaplar, bir kuruluş hesabını yönetebilir ve ardından bu kuruluştaki kullanıcı grupları ve konum grupları için izin 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 hesap otomatik olarak kullanılabilir. Kişisel hesaplar girişlerin sahibi ve yöneticisi olabilir.

Kurumsal hesap

Kuruluş hesabı, ajansınızı temsil eden üst hesaptır. Konum grubunuz ve kullanıcı gruplarınız bu klasöre kaydedilir ve kuruluştaki tüm üyeler bu klasöre erişebilir. Konumlar birden fazla kuruluşun parçası olabilir.

Benim İşletmem Hesap Yönetimi API'si ile kişisel hesapları kuruluş hesabını yönetmeye veya sahip olmaya davet etmek için accounts.admins.create yöntemini kullanabilirsiniz.

Konum grubu hesabı

Konum grubu, bir grup konumu yönetmek için kullanılır. Birden fazla konumda toplu görevler gerçekleştirmek için bir yer grubu kullanabilirsiniz. Bir konum grubuna eklediğiniz kişisel hesaplar ve kullanıcı grupları, konum grubunun izinlerini devralır.

Ayrıca konumları zincire, bölgeye veya kategoriye göre kategorilere ayırmak için konum grupları da oluşturabilirsiniz. Konumlar aynı anda birden fazla konum grubunda olabilir.

İşletme Hesabı Yönetimi API'si ile konum grupları oluşturmak ve konumları bir konum grubuna aktarmak için accounts.create yöntemini kullanabilirsiniz. API ile konum gruplarını yönetmek için kişisel hesapları da davet edebilirsiniz. Kullanıcı grupları, web arayüzünden doğrudan konum gruplarına eklenebilir.

Kullanıcı grubu hesabı

İzinleri geniş ölçekte yönetmek için kullanıcı grubu kullanın. Kullanıcı gruplarına kişisel hesaplar ekleyebilirsiniz. Ardından, kullanıcı grubuna kuruluştaki birden fazla konum grubu için yönetim erişimi verebilirsiniz. Artık kullanıcı grubundaki tüm kişisel hesaplar, konum gruplarının altındaki konumlarda yönetici işlemleri gerçekleştirebilir.

Örneğin, bir operasyon ekibine yeni bir üye katıldığında bu üyeyi doğrudan bir kullanıcı grubuna ekleyebilirsiniz. Böylece, bu ü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.

Benim İşletmem Hesabı Yönetimi API'sinde, kullanıcı grupları oluşturmak için accounts.create yöntemini kullanabilirsiniz. API'yi kullanarak kişisel hesapları hesaplar ve konumlar için yöneticileri yönetme üzere davet edebilirsiniz.

Tüm hesapların listesini çağırmak için API'yi kullanma

Erişiminiz olan tüm hesapları ve ilişkili hesap türlerini listelemek için OAuth kimlik bilgilerinizle accounts.list yöntemini çağırın. Yanıt, tüm hesapların listesini, hesap kimliklerini (ad alanında bulunur) ve hesap türlerini içerir.

İstek

Aşağıda accounts.list isteği örneği verilmiştir:

HTTP
GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

Yanıt

Aşağıda, 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 hesabı belirleyin. Ardından, ilgili hesabın erişebildiği konumların listesini almak için söz konusu hesabın ad alanıyla accounts.locations.list işlevini çağırın.

Örneğin, "Mehmet Yılmaz'ın Konum Grubu"na ait tüm konumları almak istiyorsanız aşağıdaki isteği gönderin:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

Yanıt, kullanıcının erişebildiği konumların listesini aşağıdaki gibi 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 şemada aşağıdakiler gösterilmektedir:

  • Kuruluşlarda birden fazla kullanıcı grubu bulunabilir.
  • Kullanıcı grupları birden fazla yer grubunu yönetebilir.
  • Konum grupları birden fazla konum içerebilir.
  • Yerler, kuruluşlar arasında birden fazla yer grubunu kapsayabilir.
Konum yönetimi hiyerarşisi
Şekil 1. Konum yönetimi hiyerarşisi