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

Bu kılavuz, Google Ads kampanyalarını getirmek 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'ye erişmesine izin verir ancak jeton sadece bir Google Ads hesabıyla sınırlı değildir. Jetonunuz onaylandıktan sonra, jetonla ilişkili Google Ads yönetici hesabına bağlı olmasa bile tüm Google Ads hesaplarınıza yönelik istekler için aynı jetonu kullanabilirsiniz.

Yönettiğiniz hesaplara yönetici hesabı üzerinden verilen OAuth kimlik bilgileri ile yetki verilir. Bir yönetici hesabı, tüm alt hesaplarını yönetmek için tek bir kimlik bilgisi grubuna ihtiyaç duyar.

Yalnızca onaylı jetonlar Google Ads üretimi için API'ye 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, ardından API Merkezi'ne gidin (ARAÇLAR VE AYARLAR > KURULUM > API Merkezi).

İ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 programlanabilir şekilde ayarlanabilir. Geliştirici jetonunuz onaylandıktan sonra, test hesabı yerine bir üretim hesabındaki 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 projeyle eşler ve OAuth2 kimlik doğrulaması için kullanılır. Böylece uygulamanız hesabınız adına çalışabilir. Bu bilgiler, 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 sayfasına göz atın.

OAuth2 erişimi ve yenileme jetonları

Uygulamanızın API'yi kullanarak gizli verilere erişebilmesi için uygulamanızın 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'dan almayı deneyin.

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