Search Ads 360 API, tüm isteklerin kimlik doğrulama için bir OAuth 2.0 erişim jetonu belirtmesini gerektirir. Jetonu oluşturmak ve Search Ads 360 API'sine iletmek için herhangi bir standart OAuth 2.0 kimlik doğrulama iş akışını uygulayabilirsiniz. Tamamen otomatik dönüşüm yüklemeleri ve indirme işlemleri için uygun olduğundan aşağıda açıklanan iş akışını öneririz.
Aşağıda açıklanan iş akışına alternatifler için Yüklü Uygulamalarda OAuth 2.0'ı Kullanma veya Sunucudan Sunucuya Uygulamalarda OAuth 2.0'ı Kullanma. Alternatif bir iş akışı kullanıyorsanız OAuth 2.0 yetkilendirme kodu isterken scope
parametresi olarak aşağıdaki değeri belirtin:
https://www.googleapis.com/auth/doubleclicksearch
Sunucudan sunucuya rotayı izliyorsanız hizmet hesabını Search Ads 360 kullanıcısı olarak ekleyin.
Önerilen yetkilendirme iş akışı
- Google API Konsolu'na gidip projenizi seçin.
Daha önce Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturmadıysanız İstemciniz için Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturma başlıklı makaledeki talimatları uygulayın.
Projenizin OAuth istemci kimliğini ve sırrını bulmak için aşağıdakileri yapın:
- Credentials (Kimlik Bilgileri) sayfasını açın.
- Name (Ad) sütununda, OAuth istemcinizin adını tıklayın.
- İstemci kimliği ve sırrı sayfada listelenir.
- Bir web tarayıcısı açın ve Search Ads 360'ta verilere erişim izni olan bir Google Hesabı ile Google'da oturum açın.
Bu, API istemcinizin Search Ads 360 ile kimlik doğrulama için kullanacağı Google Hesabıdır. Google Hesabı sahibi şirketinizden ayrılır ve Search Ads 360 erişimini hesaptan kaldırırsanız bu yetkilendirme iş akışını tekrarlamanız ve farklı bir Google Hesabı belirtmeniz gerekir.
- Aşağıdaki gibi Search Ads 360 yardımcı program komut dosyasını çağırarak bir yenileme jetonu alın:
sa360Api.py --login
Komut dosyası, yenileme jetonu almak için Oauth istemci kimliğini ve gizli anahtarını kullanma işlemini açıklar. Yenileme jetonu yalnızca önceki adımda oturum açtığınız Google Hesabı için geçerlidir.
Komut dosyası, bu işlem kapsamında bir URL oluşturur ve URL'yi bir web tarayıcısında ziyaret etmenizi ister.
-
Tarayıcı, OAuth istemcisinin Search Ads 360 verilerine erişmesine izin vermenizi istediğinde, daha önce oturum açtığınız Google Hesabı'nın göründüğünden emin olun. (Birden çok Google Hesabı'nda oturumunuz açıksa farklı bir hesap görebilirsiniz.)
İşlemin sonunda
sa360Api.py
komut dosyası, virgülle ayrılmış bir dize oluşturur. İlk değer sizin sağladığınız istemci kimliği, ikinci değer sağladığınız istemci sırrıdır ve üçüncü değer yenileme jetonudur. Aşağıdaki örnekte, yenileme jetonu kalın metindir:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
- İstemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu arka uç veritabanında veya uygulamanızın erişebileceği başka bir güvenli konumda depolayın.
Search Ads 360 API'sine örnek JSON istekleri göndermek için
sa360Api.py
kullanmayı planlıyorsanız virgülle ayrılmış dizenin tamamını uygun bir yerde tutun. Komut dosyasını her çağırdığınızda dizenin tamamını parametre olarak geçirirsiniz. - Uygulamanıza aşağıdakileri yapan bir kod ekleyin:
- Yeni bir OAuth 2.0 erişim jetonu almak için istemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu kullanın.
- Yeni erişim jetonunu kullanarak istekleri Search Ads 360 API'sine gönderin.
İstemci kitaplıklarını kullanıyorsanız bir sonraki bölümde yer alan Uygulamanızı Ayarlama bölümünde bu yetkilendirme kodunun uygulamanıza nasıl ekleneceği açıklanmaktadır.
İstemci kitaplıklarından birini kullanmıyorsanız yeni bir erişim jetonu almayla ilgili öneriler için Yüklü Uygulamalar için OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.