İş ortağı tarafından kontrol edilen hesapların temel hazırlığı – API Geliştirici Kılavuzu

Giriş

createAccountTree, geniş ölçekte yeni Google Analytics hesapları oluşturmak için kullanılabilen Temel Hazırlık API'sının bir parçasıdır. createAccountTicket'in aksine createAccountTree, hesap oluşturma işlemini tamamlamak için son kullanıcı etkileşimi gerektirmez; işlem tamamen otomatiktir. Bu özellik, müşteri adına kontrol ettiğiniz bir Analytics hesabını sağlamanız gerektiğinde ve söz konusu verilerin özel bir görünümünü müşterinize sunduğunuz durumlarda kullanışlıdır.

Bu API, kullanıcılarının web sitelerini veya web mülklerini kontrol eden iş ortaklarına ayrılmıştır. Kullanıcılarınız kendi web sitelerini veya web mülklerini kontrol ediyorsa bunun yerine kullanıcı tarafından kontrol edilen Analytics hesapları oluşturmalısınız.

Başlamadan Önce

Tüm Google Analytics API'lerine benzer şekilde erişilir. Temel Hazırlık API'sını kullanmaya başlamadan önce şunları yapmanız gerekir:

  • API ile çalışan programlama diline özgü istemci kitaplıklarının tam listesi için istemci kitaplıkları sayfasını inceleyin.
  • API arayüzü ve istemci kitaplığı olmadan verilere nasıl erişileceği hakkında bilgi edinmek için Referans Kılavuzu'nu okuyun.

Her istemci kitaplığı, Temel Hazırlık API'sına erişmek için tek bir analiz hizmeti nesnesi sağlar. Hizmet nesnesini oluşturmak için genellikle aşağıdaki adımları uygulamanız gerekir:

  1. Uygulamanızı Google API Konsolu'nda kaydedin.
  2. Yeni bir Google Analytics hesabı oluşturmak için yetki verin.
  3. Bir Analytics hizmet nesnesi oluşturun.

Bu adımları tamamlamadıysanız lütfen durup Merhaba Google Analytics API Eğiticisi'ni okuyun. Bu eğitim, bir Google Analytics API uygulaması oluşturmanın ilk adımlarında size yol gösterecektir. Bu eğitimi tamamladığınızda, gerçek dünyadaki görevleri yerine getirmek için Google Analytics API'lerine nasıl erişeceğinizi anlayacaksınız.

Şablon Hesabı

Bu API'yı kullanma yetkisinin bir parçası olarak, bu API için şablon hesabı görevi gören yeni bir Google Analytics Hesabı sağlamanız gerekecektir. Oluşturulan yeni hesaplar Hizmet Şartları alıcısı, Kuruluş ve çeşitli veri paylaşım ayarları gibi çeşitli ayarları şablon hesabından devralır. Şablon hesabıyla ilgili daha fazla ayrıntı ve devralınan tüm verilerin listesi için createAccountTree referansına bakın.

Hesabın Temel Hazırlığını Yapma

Yeni bir Google Analytics hesabının temel hazırlığını yapmak için createAccountTree API uç noktasına istek gönderin. Aşağıdaki temel hazırlık ayrıntılarına ihtiyacınız olacaktır:

  • Account Alanları
    • Hesap için bir accountName.
  • Web Mülkü Alanları
    • Mülk için webpropertyName.
    • websiteUrl. Bu URL, bu Analytics hesabının kullanıcı mülküyle ilişkilendirilmiş URL olmalıdır.
  • Görünüm Alanları
    • Görünüm için profileName.
    • Görünüm için timezone.

Bu bilgilere sahip olduğunuzda API uç noktasına kimliği doğrulanmış bir çağrı yapın:

POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
    "accountName": "Analytics Account",
    "webpropertyName": "Default Property",
    "profileName": "Default View",
    "timezone": "America/Los_Angeles",
    "websiteUrl": "www.example-pet-store.com",
}

İşlem başarılı olursa API, yeni oluşturulan hesap, web mülkü ve görünüm ile ilgili ayrıntıları içeren yanıt verir:

{
    "account": {
        "id": "999999999",
        "name": "Analytics Account",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "webproperty": {
        "id": "UA-999999999-1",
        "name": "Default Property",
        "websiteUrl": "www.example-pet-store.com",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    "profile": {
        "id": "999999999",
        "name": "Default View",
        "timezone": "America/Los_Angeles",
        "created": "2018-03-16T23:35:20.699Z",
        "updated": "2018-03-16T23:35:20.699Z",
        ...
    },
    ...
}

Hesap Sahipliği ve Yönetimi

Oluşturulan Google Analytics Hesabı, OAuth üzerinden yanıt için yetki veren kullanıcı hesabına ait olur. Bu nedenle, kuruluşunuzun Analytics Hesabını yönetmek için bireysel kullanıcı hesabı yerine bir hizmet hesabı kullanmasını öneririz.

Hesabı oluşturduktan sonra Management API'si ile yapılandırabilirsiniz. Aşağıda, yeni oluşturulan bir hesaba ilişkin bazı genel görevler verilmiştir:

Hesap İlişkileri Açıklaması

Tüm Google API'lerinde olduğu gibi, istek yetkilendirmesi için başlangıç noktası olarak bir Google Cloud projesi gereklidir. OAuth 2.0 belgelerinde açıklandığı gibi, API istekleri için kimlik bilgilerinizi bu hesap üzerinden yönetirsiniz. Ancak oluşturulan Google Analytics hesabının Cloud projesiyle veya bu projenin yönetici hesaplarıyla doğrudan bir bağlantısı yoktur, yalnızca isteğe yetki veren kullanıcı veya hizmet hesabıyla ilişkilidir. Analytics hesabına hesap erişimini yapılandırmanız gerekiyorsa Management API'sini kullanabilirsiniz.