Genel bakış

Curation Partners API'yi kullanarak veri segmentleri oluşturabilir ve yönetebilirsiniz. Bu API, curators.dataSegments kaynağını kullanıma sunar. Bu, entegrasyonunuz için kullanabileceğiniz oluşturulmuş istemci kitaplıklarına sahip bir REST API'dir.

Kimlik doğrulama ayarlama

Google API'leri, kimlik doğrulama ve yetkilendirme için OAuth 2.0 protokolünü kullanır. Curation Partners API'ye erişmek için hizmet hesabı oluşturma adımlarını aşağıda bulabilirsiniz.

  1. Henüz yapmadıysanız API'ye erişmek için kullanılan kimlik bilgilerinizin barındırıldığı bir Google Cloud projesi oluşturun.

  2. Google Cloud Console'da Etkin API'ler sayfasına gidin. Daha önce oluşturduğunuz projeyi seçin.

  3. Etkinleştirilen API'lerin ve hizmetlerin listesini inceleyin. Curation Partners API'ye erişmek için bu API'yi etkinleştirmeniz gerekir. Curation Partners API etkin değilse +API'leri ve hizmetleri etkinleştir'i tıklayın ve aşağıdaki talimatları uygulayın:

    1. Arama kutusunu kullanarak Curation Partners API'yi arayın.
    2. Sonuçlar sayfasında Curation Partners API'yi seçin.
    3. Etkinleştir'i tıklayın.

    Google Cloud Console arama kutusunda Curation Partners API'yi bulamamanız bilinen bir sorundur. Alternatif olarak, API'yi etkinleştirmek için Google Cloud CLI'yı kullanabilirsiniz. gcloud CLI'yı yükledikten sonra aşağıdaki komutu kullanarak Curation Partners API'yi etkinleştirebilirsiniz:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. Gezinme menüsünde Kimlik bilgileri'ni seçin.

  5. +Kimlik bilgisi oluştur'u tıklayın ve açılan açılır menüde Hizmet hesabı'nı seçin.

  6. Hizmet hesabı için bir Ad girin. Hizmet hesabı kimliği, oluşturma sırasında otomatik olarak oluşturulur. Bu değeri not edin çünkü daha sonra 14. adımda gerekecektir. İsteğe bağlı olarak bir açıklama girin. Oluştur ve devam et'i tıklayın.

  7. İsteğe bağlı olarak hizmet hesabı için izinleri yapılandırın ve Devam'ı tıklayın.

  8. İsteğe bağlı olarak, hizmet hesabı olarak işlem gerçekleştirebilecek kullanıcıları veya grupları yapılandırın ve Bitti'yi tıklayın.

  9. Yeni hizmet hesabınız Hizmet Hesapları altında listelenir. Yeni oluşturduğunuz hizmet hesabı kimliğini bulup tıklayın.

  10. Anahtarlar sekmesini tıklayın.

  11. Anahtar ekle açılır menüsünde Yeni anahtar oluştur'u seçin.

  12. Anahtar türü olarak JSON'u seçin ve Oluştur'u tıklayın.

  13. Anahtarı çalışma dizininize indirin. Anahtarınızı güvenli bir şekilde depolama hakkında daha fazla bilgi için Hizmet hesabı anahtarlarını yönetme başlıklı makaleye bakın. Anahtar, uygulamanız tarafından API çağrıları yapmak için kullanılır.

  14. Hizmet hesabını hesabınıza bağlamak için hizmet hesabı kimliğini Teknik Hesap Yöneticinizle paylaşın.

API kapsamları

API çağrısı yapmak için kullanılan bir erişim jetonu almak üzere OAuth 2.0 akışında ilerlerken bu jetonla erişilebilecek API'leri belirtmeniz gerekir. Curation Partners API için bu kapsam https://www.googleapis.com/auth/curation-partners'dır.

API'deki veri segmentlerini Gerçek Zamanlı Seçim'e kıyasla nasıl tanımlayabilirsiniz?

Seçim İş Ortağı API'sinde veri segmentleri, API'ye özel bir kaynak adıyla tanımlanır. Örneğin:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Anlık Seçim'de bir reklam fırsatı için geçerli olan veri segmentlerini belirlerken, DATA_SEGMENT_ID alanında API tarafından sağlanan tam kaynak adı yerine name kaynak kimliği değerini belirtin.

Sonraki Adımlar