Yetkilendirme ve HTTP Üst Bilgileri

. Video: Kimlik doğrulama

Hem OAuth 2.0 uygulama kimlik bilgilerine hem de geliştiricisine jetonunu Google Ads API çağırırken değiştirin. API çağrıları yapıyorsanız bir Google Ads yönetici hesabı kullanıyorsanız ayrıca bir login-customer-id başlığını kullanın. Bu sayfada, bu değerlerin nasıl ayarlanacağı ve API'ye özel olarak gönderilen ek HTTP üstbilgilerini, (REST arayüzü kullanılırken alınan)

OAuth 2.0 kimlik bilgileri

Google Ads API, API'yi tanımlamak ve yetkilendirmek için uygulama kimlik bilgilerini kullanır kabul edersiniz. Hem OAuth 2.0 istemcileri hem de hizmet hesaplar yapılandırılabilir. Ayrıntılı bilgi için yapılandırma hakkında daha fazla bilgi için OAuth2 Google Ads API.

Google API'lerini kullanmaya yeni başladıysanız şunu kullanabilirsiniz: oauth2l veya OAuth 2.0 Playground'u deneyin uygulama kimlik bilgilerinizi ve Google Ads API'sini kontrol etmeniz gerekir. uygulamasını indirin.

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

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

OAuth istemcisi oluşturduktan sonra masaüstü uygulama akışını uygulayın talimatları veya web uygulaması akışı talimatları uygulayın: yenileme jetonu ve erişim jetonu oluşturun.

Hizmet hesaplarını kullanma

Hizmet Şartları'ndaki genel talimatları Hesaplar Google Ads API için hizmet hesabı erişimini ayarlama kılavuzu.

Google Ads hesabınıza erişmek için bir hizmet hesabı oluşturduktan sonra Sunucudan sunucuya OAuth 2.0 kullanma Uygulamalar rehberini seçin. HTTP/REST sekmesini seçtiğinizden emin olun. Google Ads API için kullanılacak scope erişim https://www.googleapis.com/auth/adwords.

Yeni erişim jetonları oluşturma

Bir istemci kimliği, istemci gizli anahtarı ve yenileme jetonunuz olduğunda şunları yapabilirsiniz: API çağrılarında kullanılmak üzere yeni bir curl komut satırı aracı:

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 curl isteği tarafından döndürülen erişim jetonunu Authorization Google Ads API'ye yapılan her API çağrısının HTTP başlığı:

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 simgesi

Google Ads API, API. Yönetici hesabınız için doğrudan Google Ads kullanıcı arayüzü. Geliştirici jetonu kullanmaya başlama hakkında daha fazla bilgi için bkz. Geliştirici Simgenizi Alın.

Geliştirici jeton değerinizi developer-token HTTP'ye eklemeniz gerekir üstbilgisini içermelidir.

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 müşteri hesabına (yani müşteri hesaplarından birine API çağrıları yapmak için yönetici olarak giriş yaptığında) login-customer-id HTTP üst bilgisini de sağlaması gerekir. Bu değer, API çağrısını yapan yöneticinin Google Ads müşteri kimliği.

Bu başlığı eklemek, Google Ads kullanıcı arayüzünde hesap seçmekle eşdeğerdir veya hesabınızın sağ üst köşesindeki profil resminizi tıkladıktan sonra yapalım. Müşteri kimliğini belirtirken tüm kısa çizgileri (—) ve Örneğin, 123-456-7890 yerine 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 Dönüşümleri bağlı bir Google Ads'e yükleyerek hesap. Bkz. API Çağrı Yapısı kılavuzu inceleyebilirsiniz.

...
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. Zaman belirli API çağrılarıyla ilgili hata ayıklama veya sorun giderme işlemleri, request-id Google geliştiricisiyle iletişim kurarken elinizin altında bulunması gereken önemli bir tanımlayıcıdır destek.

request-id: 2a5Cj89VV7CNhya1DZjjrC