Google Ads API'yi çağırırken OAuth 2.0 kimlik bilgilerine 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 üstbilgisi de 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 yetkilendirmek için OAuth 2.0'ı kullanır. Hem OAuth 2.0 kullanıcı kimlik doğrulama akışı hem de hizmet hesabı akışı desteklenir. Daha fazla bilgi için Google Ads API'de OAuth 2.0 başlıklı makaleyi inceleyin.
Google API'lerini yeni kullanmaya başladıysanız uygulamanız için kod yazmadan önce OAuth 2.0 kimlik bilgileri ve Google Ads API ile denemeler yapmak için gcloud CLI'yı veya OAuth 2.0 Playground'u kullanabilirsiniz.
OAuth 2.0 yetkilendirme iş akışlarını uygulamak için https://oauth.net/code/ adresinde bulunan OAuth 2.0 kitaplıklarından birini kullanmanızı öneririz. Ancak, kendiniz uygulamanız gerekebileceği için curl talimatlarını listeledik.
Hizmet hesapları
Google Ads API için Google Cloud projesi yapılandırma adımlarını uygulayın. Hizmet hesabı e-posta adresini ve hizmet hesabı anahtarını kaydedin. Ardından, Google Ads hesabınıza erişmek için hizmet hesabını ayarlamak üzere Hizmet Hesapları rehberindeki genel talimatları uygulayın.
Kullanıcı kimlik doğrulaması
Google Ads API için Google Cloud Console projesi yapılandırma adımlarını uygulayın. İstemci kimliğini ve istemci gizli anahtarını kaydedin. Ardından, masaüstü uygulaması akışı talimatlarını veya web uygulaması akışı talimatlarını uygulayarak yenileme jetonu ve erişim jetonu oluşturun. Google Ads API erişimi için scope kullanılacak https://www.googleapis.com/auth/adwords.
Yeni erişim jetonları oluşturma
Hizmet hesapları
Hizmet hesabı e-posta adresiniz ve hizmet hesabı anahtarınız olduğunda, Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma kılavuzundaki talimatları uygulayarak JWT talebi grubu oluşturun. Bu grup daha sonra OAuth 2.0 erişim jetonu almak için kullanılabilir. Rehberi uygularken HTTP/REST sekmesini seçtiğinizden emin olun. Google Ads API erişimi için kullanılacak OAuth 2.0 scope değeri
https://www.googleapis.com/auth/adwords. Ayrıca, JWT talebi kümesini oluştururken sub parametresini atlayabilirsiniz. Çünkü kurulum adımları, hizmet hesabına Google Ads hesabına doğrudan erişim izni verir. Böylece, Google Ads kullanıcısının kimliğine bürünme ihtiyacı ortadan kalkar.
Ardından, Google Ads API'ye yapılan her API çağrısının Authorization HTTP üstbilgisinde erişim jetonunu kullanırsınız:
GET /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Kullanıcı kimlik doğrulaması
OAuth 2.0 istemci kimliği, istemci gizli anahtarı ve yenileme jetonunuz olduğunda, curl komut satırı aracıyla 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/tokenArdı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 /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
İstek başlıkları
Aşağıdaki bölümlerde, Google Ads API'ye istekte bulunurken gerekli olan veya kullanılan HTTP üstbilgileri açıklanmaktadır.
Giriş müşteri kimliği
Bir yöneticinin bir müşteri hesabına yaptığı Google Ads API çağrıları için (yani, müşteri hesaplarından birine API çağrıları yapmak üzere yönetici olarak oturum açarken) 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. Giriş müşteri kimliği hakkında daha fazla bilgi edinmek için Google Ads erişim modeli rehberine bakın.
GET /v25/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Bağlı müşteri kimliği
Bağlı müşteri kimliği üstbilgisi, bağlı bir Google Ads hesabında işlem yaparken iş ortakları (ör. üçüncü taraf uygulama analizi sağlayıcıları veya veri iş ortakları) tarafından kullanılır. Daha fazla bilgi için API Çağrısı Yapısı Kılavuzu'na bakın.
Authorization: Bearer ACCESS_TOKEN
login-customer-id: PARTNER_CUSTOMER_ID
linked-customer-id: ADVERTISER_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ı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