Search Ads 360 Reporting API'yi çağırırken OAuth 2.0 uygulama kimlik bilgilerine ihtiyacınız vardır. Search Ads 360 yönetici hesabı olarak API çağrıları yapıyorsanız her istekle birlikte bir login-customer-id üstbilgisi de belirtmeniz gerekir. Bu sayfada, bu değerlerin nasıl ayarlanacağı açıklanmakta ve REST arayüzü kullanıldığında gönderilen ve alınan API'ye özgü birkaç ek HTTP üst bilgisi belgelenmektedir.
OAuth 2.0 kimlik bilgileri
Search Ads 360 Reporting API, API isteklerini tanımlamak ve yetkilendirmek için uygulama kimlik bilgilerini kullanır. OAuth 2.0 istemcileri yapılandırılabilir. Tüm Search Ads 360 Reporting API çağrıları OAuth2 üzerinden yetkilendirilmelidir. OAuth2, Search Ads 360 Reporting API istemci uygulamanızın kullanıcının giriş bilgilerini işlemesi veya depolaması gerekmeden kullanıcının Search Ads 360 hesabına erişmesini sağlar.
Google API'lerini kullanmaya yeni başladıysanız uygulamanızın kodunu yazmadan önce oauth2l'yi veya OAuth 2.0 Playground'ı kullanarak uygulama kimlik bilgilerini ve Search Ads 360 Reporting API'yi deneyebilirsiniz. Ayrıca, sağlanan kullanıcı kimlik bilgisi oluşturma komut dosyasını çalıştırarak OAuth yenileme jetonu da oluşturabilirsiniz.
Yeni erişim jetonları oluşturma
İstemci kimliğiniz, istemci gizli anahtarınız ve yenileme jetonunuz olduktan sonra curl komut satırı aracını kullanarak API çağrılarında kullanılacak yeni bir erişim jetonu oluşturabilirsiniz:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token
Ardından, curl isteği tarafından döndürülen erişim jetonunu Search Ads 360 Reporting API'ye yapılan her API çağrısının Authorization HTTP üst bilgisinde kullanırsınız:
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
İstek başlıkları
Giriş müşteri kimliği
Bir yöneticinin müşteri hesabına yaptığı Search Ads 360 Reporting API çağrıları için (yani, müşteri hesaplarından birine API çağrısı yapmak için yönetici olarak giriş yaptığınızda) login-customer-id HTTP üstbilgisini de sağlamanız gerekir. Bu değer, API çağrısını yapan yöneticinin Search Ads 360 müşteri kimliğini temsil eder.
Bu başlığı eklemek, oturum açtıktan veya sayfanın sağ üst köşesindeki profil resminizi tıkladıktan sonra Search Ads 360 kullanıcı arayüzünde bir hesap seçmekle aynıdır. Müşteri kimliğini belirtirken kısa çizgileri (—) kaldırdığınızdan emin olun. Örneğin: 123-456-7890 yerine 1234567890.
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Yanıt başlıkları
Aşağıdaki üst bilgiler, API'den gelen HTTP yanıtlarında döndürülür.
Talep numarası
request-id, API isteğini benzersiz şekilde tanımlayan bir dizedir. Belirli API çağrılarıyla ilgili sorunları ayıklamak veya gidermek için request-id, Google geliştirici desteğiyle iletişime geçerken kullanabileceğiniz önemli bir tanımlayıcıdır.
request-id: 2a5Cj89VV7CNhya1DZjjrC