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 istekte 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 açıklanmaktadır.
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 gerekirse 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ı oluşturmak ü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, yenileme jetonu ve erişim jetonu oluşturmak için masaüstü uygulaması akış talimatlarını veya web uygulaması akış talimatlarını uygulayın. Google Ads API erişimi için kullanılacak scope: 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:
https://www.googleapis.com/auth/adwords. Ayrıca, JWT hak talebi kümesini oluştururken sub parametresini atlayabilirsiniz. Bunun nedeni, kurulum adımlarının hizmet hesabına Google Ads hesabına doğrudan erişim izni vermesi ve böylece bir Google Ads kullanıcısının kimliğine bürünme ihtiyacını ortadan kaldırmasıdır.
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 /v26/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Kullanıcı kimlik doğrulaması
OAuth 2.0 istemci kimliğiniz, istemci gizli anahtarınız 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/tokenArdından, Google Ads API'ye yapılan her API çağrısının HTTP başlığında, curl isteği tarafından döndürülen erişim jetonunu kullanırsınız:Authorization
GET /v26/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 istek gönderirken gerekli olan veya kullanılan HTTP üstbilgileri açıklanmaktadır.
Giriş yapan 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, bir yöneticinin müşteri hesaplarından birine API çağrıları yapmak üzere yönetici olarak giriş yapması durumunda) login-customer-id HTTP başlığını da sağlamanız gerekir. Bu değer, API çağrısı yapan yöneticinin Google Ads müşteri kimliğini temsil eder.
Bu üstbilgiyi 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 tireleri (—) 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 /v26/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 başlığı, bağlı bir Google Ads hesabı üzerinde 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ı
API'den gelen HTTP yanıtlarında aşağıdaki üstbilgiler 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 Ekibi ile iletişime geçtiğinizde elinizin altında olması gereken önemli bir tanımlayıcıdır.
request-id: 2a5Cj89VV7CNhya1DZjjrC