Google Ads API'yi çağırırken hem OAuth 2.0 uygulama kimlik bilgilerine hem de bir geliştirici jetonuna ihtiyacınız vardır. Bir Google Ads yönetici hesabıyla API çağrıları yapıyorsanız her istekte bir login-customer-id başlığı 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 özel bazı ek 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 edinmek için Google Ads API'de OAuth2 bölümüne bakın.
Google API'lerini kullanmaya yeni başladıysanız uygulamanızın kodunu yazmadan önce uygulama kimlik bilgileri ve Google Ads API ile denemeler yapmak için oauth2l veya OAuth 2.0 Playground'u kullanabilirsiniz.
Masaüstü veya web uygulaması akışlarını kullanma
Google Ads API için bir Google API Konsolu projesini yapılandırma adımlarını uygulayın. İstemci kimliğini ve istemci gizli anahtarını kaydedin, ardından bu sayfaya geri dönün.
OAuth istemcisi oluşturduktan sonra yenileme jetonu ve erişim jetonu oluşturmak için masaüstü uygulama 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 yaygın talimatları uygulayın.
Google Ads hesabınıza erişmek için bir hizmet hesabı oluşturduktan sonra, Sunucudan Sunucuya Uygulamalar için OAuth 2.0 Kullanma
kılavuzunu izleyin ve HTTP/REST sekmesini seçtiğinizden emin olun. Google Ads API erişimi için kullanılacak scope
https://www.googleapis.com/auth/adwords değeridir.
Yeni erişim jetonları oluşturma
Bir istemci kimliği, istemci gizli anahtarı ve yenileme jetonunuz olduğunda curl komut satırı aracıyla 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, Google Ads 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 /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
İstek başlıkları
Geliştirici jetonu
Google Ads API, API'ye çağrı yapmak için bir geliştirici jetonu da gerektirir. Yönetici hesabınız için doğrudan Google Ads kullanıcı arayüzünden jeton başvurusu yapabilirsiniz. Geliştirici jetonu kullanmaya ilişkin daha fazla bilgi için Geliştirici Jetonunuzu Alma bölümüne bakın.
Geliştirici jeton değerinizi, Google Ads API'ye yapılan her API çağrısının developer-token HTTP başlığına eklemeniz gerekir:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Giriş müşteri kimliği
Bir yönetici tarafından bir müşteri hesabına yapılan Google Ads 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ı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 hesap seçmeyle eşdeğerdir. Müşteri kimliğini belirtirken tüm kısa çizgileri (—) kaldırdığınızdan emin olun. Örneğin: 123-456-7890 değil, 1234567890.
GET /v17/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ğrı Yapısı kılavuzunu inceleyin.
...
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 üstbilgiler, API'den alınan 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 hataları ayıklarken veya sorunları giderirken request-id, Google geliştirici destek ekibiyle iletişime geçerken yanınızda bulundurmanız gereken önemli bir tanımlayıcıdır.
request-id: 2a5Cj89VV7CNhya1DZjjrC