Ads API'lerinde rıza ayrıştırma

20 Şubat 2025, Perşembe

Neler değişecek?
1 Mayıs 2025 haftasından itibaren, OAuth kullanıcı kimlik doğrulaması için izinleri ayırma özelliğini 2019'dan önce oluşturulan tüm Google Cloud projelerinde kullanıma sunacağız. 2019'dan önce oluşturulmuş bir Google Cloud projesi üzerinden Google Ads ile ilgili bir API kullanan bir uygulamanız varsa 1 Mayıs 2025'ten önce uygulamanızı, ayrıştırılmış kullanıcı rızasını işleyecek şekilde güncellemeniz gerekebilir.

Arka plan
OAuth kullanıcı kimlik doğrulama akışı için izinleri ayrı ayrı verme özelliği, kullanıcıların "ya hep ya hiç" yaklaşımı yerine uygulamanızı hangi OAuth kapsamları için yetkilendirmek istediklerini özelleştirmelerine olanak tanır. 2019'dan sonra oluşturulan tüm Google Cloud Console projelerinde bu özellik etkinleştirilmiştir. 2019'dan önce oluşturulan tüm projelerde ise bu özellik devre dışı bırakılmıştır.

Bu değişiklikten kimler etkileniyor?
Aşağıdaki koşulların TÜMÜ karşılanıyorsa bu değişiklikten etkileneceksiniz:

1. API uygulamanız, 2019'dan önce oluşturulmuş bir Google Cloud Console projesi kullanıyor.
2. Uygulamanız, OAuth 2.0 kullanıcı rızası akışını uygular. Bu, kullanıcının Google Hesabı ile giriş yaptığı ve uygulamanızın istediği bir veya daha fazla izni verdiği bir kimlik doğrulama iş akışıdır.
3. Uygulamanız birden fazla Google API'si kullanıyor ve API'lerden biri aşağıda listelenen Google Ads ile ilgili API'lerden biri.

Bu değişiklikten kimler etkilenmez?

• Mevcut yenileme jetonları: Bu değişiklik, mevcut kullanıcı kimlik doğrulamalarınızı etkilemez. Mevcut yenileme jetonlarınız herhangi bir değişiklik veya yeniden kimlik doğrulama olmadan çalışmaya devam edecek.
• Tek kapsamlı uygulamalar: Uygulamanız yalnızca bir Google API kapsamı kullanıyorsa ayrıştırılacak birden fazla OAuth kapsamı olmadığından bu değişiklikten etkilenmez.
• Tek kullanıcılı uygulamalar/Manuel olarak kimliği doğrulanmış uygulamalar: Uygulamanızda açık bir OAuth kullanıcı kimlik doğrulama iş akışı uygulanmamıştır. Bunun yerine, kullanıcının kimliğini doğrulamak için GenerateUserCredentials, gcloud CLI veya OAuth Playground gibi manuel bir kimlik doğrulama komut dosyası kullanır ve ardından bu kimlik bilgilerini uzun bir süre boyunca kullanırsınız. Kimlik doğrulama sırasında uygulamanızın gerektirdiği tüm kapsamları seçtiğiniz için uygulamanız bu değişiklikten etkilenmez.
• Hizmet hesapları: Uygulamanız, API çağrılarınızın kimliğini doğrulamak için bir hizmet hesabı kullanıyorsa bu değişiklikten etkilenmezsiniz.

Ne yapmam gerekiyor?
Uygulamanızın kısmi kullanıcı rızasını işleyebildiğinden emin olmanız gerekir. Bunu yapmak için:

1. OAuth akışınıza include_granted_scopes parametresini ekleyerek kullanıcının izin verdiği OAuth kapsamlarının listesini isteyin.
2. Kullanıcının OAuth yanıtında izin verdiği OAuth kapsamlarının gerçek listesini inceleyin.
3. Uygulamanızda artımlı yetkilendirme uygulayın.

Ayrıntılı izinleri yönetmeyle ilgili şartlar ve en iyi uygulamalar hakkında bilgi edinmek için OAuth ayrıntılı izin kılavuzumuzu inceleyin.

Bu özelliği nasıl test edebilirim?
Bu özelliği test etmenin iki yolu vardır:

1. Yeni bir Google Cloud projesi oluşturun: Yeni Google Cloud projelerinde OAuth rıza ayrıştırması etkinleştirilmiştir. Bu nedenle, yeni bir Google Cloud projesi oluşturabilir ve uygulamanızı test etmek için kullanabilirsiniz.
2. Mevcut projenizde izinleri ayrı ayrı istemeyi etkinleştirme: OAuth yetkilendirme isteğinizde enable_granular_consent parametresini "true" olarak ayarlayabilirsiniz.

Hangi API kapsamları etkileniyor?
Ads ile ilgili aşağıdaki API'ler bu değişiklikten etkilenir.

API	OAuth Kapsamı
Google Ads API	https://adwords.google.com/api/adwords
Google Ad Manager API (SOAP API, Beta)	https://www.googleapis.com/auth/dfp https://www.googleapis.com/auth/admanager
Bid Manager API	https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping	https://www.googleapis.com/auth/content
Display & Video 360 API	https://www.googleapis.com/auth/display-video-mediaplanning https://www.googleapis.com/auth/display-video-user-management
AdMob API	https://www.googleapis.com/auth/admob.report https://www.googleapis.com/auth/admob.googlebidding.readwrite https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API	https://www.googleapis.com/auth/adsensehost https://www.googleapis.com/auth/adsense https://www.googleapis.com/auth/adsense.readonly
Google Analytics API	https://www.googleapis.com/auth/analytics https://www.googleapis.com/auth/analytics.readonly https://www.googleapis.com/auth/analytics.edit https://www.googleapis.com/auth/analytics.manage.users https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.provision https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API'si	https://www.googleapis.com/auth/ddmconversions https://www.googleapis.com/auth/dfareporting https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API	https://www.googleapis.com/auth/doubleclicksearch
Google Etiket Yöneticisi API'si	https://www.googleapis.com/auth/tagmanager.delete.containers https://www.googleapis.com/auth/tagmanager.edit.containers https://www.googleapis.com/auth/tagmanager.edit.containerversions https://www.googleapis.com/auth/tagmanager.manage.accounts https://www.googleapis.com/auth/tagmanager.manage.users https://www.googleapis.com/auth/tagmanager.publish https://www.googleapis.com/auth/tagmanager.readonly
Real-Time Bidding API	https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API	https://www.googleapis.com/auth/authorized-buyers-marketplace https://www.googleapis.com/auth/adexchange.buyer

Nasıl yardım alabilirsiniz?
Sorularınız varsa veya yardıma ihtiyacınız olursa ilgili API'nin destek ekibiyle iletişime geçebilirsiniz.

 - Anash P. Oommen, Google Ads API Ekibi

Etiketler: authentication, oauth