Yetkilendirme ve HTTP Üst Bilgileri

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 istekte bir login-customer-id üstbilgisi de belirtmeniz gerekir. Bu sayfada, bu değerlerin nasıl ayarlanacağı açıklanmakta ve REST arayüzü kullanılırken gönderilen ve alınan API'ye özgü birkaç ek HTTP üstbilgisi 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 yeni kullanmaya başladıysanız uygulamanızın kodunu yazmadan önce oauth2l veya OAuth 2.0 Playground'u kullanarak uygulama kimlik bilgileri ve Search Ads 360 Raporlama API'si ile denemeler yapabilirsiniz. Ayrıca, sağlanan kullanıcı kimliği 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 jetonunuz olduğunda 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, Search Ads 360 Reporting API'ye yapılan her API çağrısının Authorization HTTP üstbilgisinde 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önetici tarafından bir müşteri hesabına yapılan 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ş yapıldığında) login-customer-id HTTP üstbilgisini 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 başlığı eklemek, oturum açtıktan sonra veya sayfanın sağ üst köşesindeki profil resminizi tıkladıktan sonra Search Ads 360 kullanıcı arayüzünde bir hesap seçmeye eşdeğerdir. Müşteri kimliğini belirtirken kısa çizgileri (—) kaldırdığınızdan emin olun. Örneğin: 1234567890, 123-456-7890 değil.

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 başlıklar, 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ıklarken veya giderirken request-id, Google geliştirici destek ekibiyle iletişime geçerken elinizin altında bulundurmanız gereken önemli bir tanımlayıcıdır.

request-id: 2a5Cj89VV7CNhya1DZjjrC