Search Ads 360 Reporting API'yi çağırırken OAuth 2.0 uygulaması 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 başlığı da belirtmeniz gerekir. Bu sayfada, bu değerlerin nasıl ayarlanacağı ve REST arayüzü kullanılırken gönderilen ve alınan API'ye özgü birkaç ek HTTP üst bilgisini belgeleyen durumlar açıklanmaktadır.
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şlemek veya depolamak zorunda kalmadan 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 uygulama kimlik bilgileri ve Search Ads 360 Reporting API ile denemeler yapmak için oauth2l veya OAuth 2.0 Playground'u kullanabilirsiniz. Sağlanan kullanıcı kimlik bilgisi oluşturma komut dosyasını çalıştırarak bir OAuth yenileme jetonu da oluşturabilirsiniz.
Yeni erişim jetonları oluşturma
İstemci kimliği, istemci gizli anahtarı ve yenileme jetonunu oluşturduktan sonra curl komut satırı aracını kullanarak API çağrılarında kullanmak üzere 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
Daha sonra, Search Ads 360 Reporting API'ye yapılan her API çağrısının Authorization HTTP başlığında curl isteği tarafından döndürülen erişim jetonunu 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ıları yapmak üzere yönetici olarak giriş yaparken) login-customer-id HTTP üst bilgisini de sağlamanız gerekir. Bu değer, API çağrısı yapan yöneticinin Search Ads 360 müşteri kimliğini temsil eder.
Bu üstbilgiyi 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 hesap seçmeye eşdeğerdir. Müşteri kimliğini belirtirken tire işaretlerini (-) kaldırdığınızdan emin olun. Örneğin: 123-456-7890 değil 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 üstbilgiler, 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ında hata ayıklarken veya sorunları giderirken request-id, Google geliştirici desteğiyle iletişime geçerken yararlanabileceğiniz önemli bir tanımlayıcıdır.
request-id: 2a5Cj89VV7CNhya1DZjjrC