Yetkilendirme ve HTTP Üst Bilgileri

ondemand_video 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-id başlığı 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ü birkaç ek HTTP üstbilgisi 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'lerini yeni kullanmaya 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 Google API Konsolu projesi yapılandırma adımlarını uygulayın. İstemci kimliğini ve istemci gizli anahtarını kaydedip 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 için hizmet hesabı erişimini ayarlamak üzere Hizmet Hesapları rehberindeki genel talimatları uygulayın.

Google Ads hesabınıza erişmek için bir hizmet hesabı oluşturduktan sonra HTTP/REST sekmesini seçtiğinizden emin olarak Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma kılavuzunu izleyin. Google Ads API erişimi için kullanılacak scope, https://www.googleapis.com/auth/adwords'dir.

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, Google Ads 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 /v21/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'ye yapılan çağrılar için geliştirici jetonu da gerekir. Yönetici hesabınız için jetona doğrudan Google Ads kullanıcı arayüzünden başvurabilirsiniz. Geliştirici jetonuyla kurulum hakkında daha fazla bilgi için Geliştirici Jetonunuzu Alma başlıklı makaleyi inceleyin.

Google Ads API'ye yapılan her API çağrısının developer-token HTTP üstbilgisine geliştirici jetonu değerinizi eklemeniz gerekir:

GET /v21/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, yöneticinin müşteri hesaplarından birine API çağrıları yapmak üzere yönetici olarak giriş yaptığı durumlarda) login-customer-id HTTP üstbilgisini de sağlamanız gerekir. Bu değer, API çağrısı yapan yöneticinin Google Ads müşteri kimliğini temsil eder.

Bu başlığı eklemek, oturum açtıktan sonra Google Ads kullanıcı arayüzünde bir hesap seçmeye veya sayfanın sağ üst köşesindeki profil resminizi tıklamaya 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 /v21/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 dönüşümler bağlı bir Google Ads hesabına yüklenirken üçüncü taraf uygulama analizi sağlayıcıları tarafından kullanılır. Daha fazla bilgi için API Çağrısı Yapısı Kılavuzu'na göz atı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 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