Yetkilendirme ve HTTP Üst Bilgileri

Video: Kimlik doğrulama

Google Ads API'yi çağırırken hem OAuth 2.0 uygulama kimlik bilgilerine hem de geliştirici jetonuna ihtiyacınız vardır. Google Ads yönetici hesabıyla API çağrıları yapıyorsanız her istekle birlikte bir login-customer-idbaşlık da 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ü çeşitli HTTP üstbilgileri belgelenmektedir.

OAuth 2.0 kimlik bilgileri

Google Ads API, API isteklerini tanımlamak ve yetkilendirmek için uygulama kimlik bilgilerini kullanır. Hem OAuth 2.0 istemcileri hem de hizmet hesapları yapılandırılabilir. İstemci tarafı yetkilendirmeyi yapılandırma hakkında daha fazla bilgi için Google Ads API'de OAuth2 başlıklı makaleyi inceleyin.

Google API'leri kullanmaya yeni başladıysanız uygulamanızın kodunu yazmadan önce oauth2l'yi veya OAuth 2.0 Playground'u kullanarak uygulama kimlik bilgilerini ve Google Ads API'yi deneyebilirsiniz.

Masaüstü veya web uygulaması akışlarını kullanma

Google Ads API için Google API Konsolu projesi yapılandırma adımlarını uygulayın. İstemci kimliğini ve istemci gizli anahtarını kaydedin, ardından bu sayfaya dönün.

OAuth istemcisi oluşturduktan sonra yeniden yenileme jetonu ve erişim jetonu oluşturmak için masaüstü uygulaması akışı talimatlarını veya web uygulaması akışı talimatlarını uygulayın.

Hizmet hesaplarını kullanma

Google Ads API için hizmet hesabı erişimini ayarlamak üzere Hizmet Hesapları kılavuzundaki genel talimatları uygulayın.

Google Ads hesabınıza erişmek için bir hizmet hesabı oluşturduktan sonra HTTP/REST sekmesini seçerek Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma kılavuzunu uygulayın. Google Ads API erişimi için kullanılacak scope, https://www.googleapis.com/auth/adwords olmalıdır.

Yeni erişim jetonları oluşturma

İstemci kimliğiniz, istemci gizli anahtarınız ve yeniden 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 Google Ads API'ye yapılan her API çağrısının Authorization HTTP üst bilgisinde kullanırsınız:

GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

İstek başlıkları

Geliştirici simgesi

Google Ads API'nin API'ye çağrı gönderebilmesi için geliştirici jetonu da gerekir. Yönetici hesabınız için doğrudan Google Ads kullanıcı arayüzünden jeton başvurusunda bulunabilirsiniz. Geliştirici jetonu ayarlama hakkında daha fazla bilgi için Geliştirici Jetonunuzu Alın başlıklı makaleyi inceleyin.

Geliştirici jetonu değerinizi, Google Ads API'ye yapılan her API çağrısının developer-token HTTP başlığına eklemeniz gerekir:

GET /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

Giriş müşteri kimliği

Bir yöneticinin müşteri hesabına yaptığı Google Ads 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 Google Ads 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 Google Ads 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 /v19/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID

Bağlı müşteri kimliği

Bu başlık yalnızca üçüncü taraf uygulama analizi sağlayıcıları tarafından bağlı bir Google Ads hesabına dönüşüm yüklerken kullanılır. Daha fazla bilgi için API Çağırma Yapısı kılavuzuna bakın.

...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_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