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 kullanmaya yeni başladıysanız uygulamanız için kod yazmadan önce OAuth 2.0 kimlik bilgileri ve Google Ads API ile denemeler yapmak üzere gcloud komut satırı aracını 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 diye 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 üzere hizmet hesabını ayarlamak için Hizmet Hesapları kılavuzundaki 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-postası ve hizmet hesabı anahtarı elinizde olduğunda, Sunucudan Sunucuya Uygulamalar için OAuth 2.0 Kullanma kılavuzunu takip ederek JWT talep grubu oluşturun. Bu talep grubu daha sonra OAuth 2.0 erişim jetonu almak için kullanılabilir. Kılavuzu takip ederken 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ğ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 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öneticinin 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 giriş yaparken) login-customer-id HTTP başlığını da 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 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: 123-456-7890 değil, 1234567890. Giriş müşteri kimliği hakkında daha fazla bilgi edinmek için Google Ads erişim modeli kılavuzuna 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ılavuzuna 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