Video: Authentication (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 olacaktır. Bir Google Ads yönetici hesabıyla API çağrıları yapıyorsanız her istekle birlikte bir login-customer-id üstbilgisi belirtmeniz de 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 ek birkaç HTTP üst bilgisi 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 bölümüne bakın.
Google API'leri konusunda yeniyseniz 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ı kaydettikten sonra bu sayfaya geri dönün.
OAuth istemcisi oluşturduktan sonra masaüstü uygulaması akış talimatlarını veya web uygulaması akış talimatlarını uygulayarak yenileme jetonu ve erişim jetonu oluşturun.
Hizmet hesaplarını kullanma
Google Ads API hizmet hesabı erişimini ayarlamak için Hizmet Hesapları kılavuzundaki genel talimatları uygulayın.
Google Ads hesabınıza erişmek üzere bir hizmet hesabı oluşturduktan sonra, Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma kılavuzundaki talimatları uygulayarak HTTP/REST sekmesini seçtiğinizden emin olun. Google Ads API erişimi için kullanılacak scope: https://www.googleapis.com/auth/adwords.
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, 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 /v16/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ı yapabilmek için bir geliştirici jetonu da gerektirir. Doğrudan Google Ads kullanıcı arayüzünden yönetici hesabınız için jeton başvurusunda bulunabilirsiniz. Geliştirici jetonuyla ilgili kurulum hakkında daha fazla bilgi için Geliştirici Simgenizi Edinme 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 üst bilgisine eklemeniz gerekir:
GET /v16/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
Giriş müşteri kimliği
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 üstbilgiyi 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ç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 /v16/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 ayrıntı için API Çağrı 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 ü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