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-id
baş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