Hızlı başlangıç kılavuzu

Bu kılavuz, Google Ads kampanyalarını almak için bir istemci kitaplığı kullanır.

API erişimini etkinleştirmek için önce gerekli OAuth2 kimlik bilgilerini alın.

Ardından, yetkilendirme ve hesap ayrıntılarını bir yapılandırma dosyasına ekleyin. Yapılandırma dosyası ayarlandıktan sonra API'yi çağırmaya hazır olursunuz.

İstemci kitaplığı için yapılandırma parametreleri

İstemci kitaplığınızın yapılandırma dosyasında aşağıdaki bilgileri sağlayın.

Geliştirici jetonu

Geliştirici jetonunuz, uygulamanızın API'ya erişmesine izin verir, ancak jeton yalnızca bir Google Ads hesabıyla sınırlı değildir. Jetonunuz onaylandıktan sonra, jetonla ilişkilendirilmiş Google Ads yönetici hesabına bağlı olmasalar bile tüm Google Ads hesaplarınıza yapılan istekler için aynı jetonu kullanabilirsiniz.

Yönettiğiniz hesaplar, yönetici hesabındaki OAuth kimlik bilgileri tarafından yetkilendirilir. Yönetici hesabı, tüm alt hesaplarını yönetmek için yalnızca bir kimlik bilgisi grubu gerektirir.

Üretim Google Ads hesapları için API'ye yalnızca onaylı jetonlar bağlanabilir; beklemedeki jetonlar yalnızca test hesaplarına bağlanabilir.

Geliştirici jetonunuzu almak için yönetici hesabınızda oturum açın ve ardından API Merkezi'ne (TOOLS & SETTINGS > setup > API Center) gidin.

İstemci müşteri kimliği

Müşteri müşteri kimliği, API ile yönetmek istediğiniz Google Ads müşteri hesabının hesap numarasıdır. Genellikle 123-456-7890 biçimindedir.

İsteğe bağlı olarak, istemci müşteri kimliği yapılandırma dosyasının dışında bırakılabilir ve programatik olarak ayarlanabilir. Geliştirici jetonunuz onaylandıktan sonra, bir test hesabı yerine üretim hesabındaki bir müşteri müşteri kimliğini kullanabilirsiniz.

OAuth2 istemci kimliği ve istemci gizli anahtarı

OAuth2 istemci kimliği ve istemci gizli anahtarı, istemci uygulamanızı Google API Konsolu'ndaki bir projeye eşler ve uygulamanızın hesabınız adına çalışabilmesini sağlamak için OAuth2 kimlik doğrulaması için kullanılır. Uygulamanızı Google'a tanıtır ve Google Ads kullanıcılarını yönetmek için OAuth jetonları oluşturmanıza olanak tanır. Daha fazla bilgi için İstemci kimliği ve istemci gizli anahtarı oluşturma başlıklı makaleye bakın.

OAuth2 erişimi ve yenileme jetonları

Uygulamanızın API kullanarak gizli verilere erişebilmesi için önce API'ye erişim izni veren bir OAuth2 erişim jetonu alması gerekir.

İstemci kitaplıklarını kullanıyorsanız OAuth2 erişim jetonu sizin için otomatik olarak gerçekleştirilir. Aksi takdirde, jetonları OAuth Playground üzerinden almayı deneyin.

OAuth2 erişim jetonlarının süresi sınırlı bir süre sonra dolar. Bu nedenle, istemci kitaplıklarında OAuth2 erişim jetonunu otomatik olarak yeniden oluşturmak için OAuth2 yenileme jetonu kullanılır. Erişim ve yenileme jetonu, yenileme jetonunu oluşturma talimatlarına sahiptir.