Sorun giderme

Bu dokümandaki bilgiler, Abonelik Bağlama işlemini uygularken karşılaşabileceğiniz sorunları gidermenize yardımcı olabilir.

Abonelik Bağlama istemi yükleme ekranında takılı kaldı

Hata örneği:

Yükleme simgesi

Şekil 1. Abonelik Bağlama istemi yüklenmiyor.

Bu sorunu gidermek için aşağıdakileri kontrol edin:

  • Test alt alanları dahil olmak üzere sayfaların kaynaklarını Yayıncı Merkezi'nin yayın ayarlarında ek URL'ler olarak eklediğinizden emin olun.
  • Kapsamı genişletilmiş erişim veya kurumsal Okuyucu Gelirleri Yöneticisi uygulamalarında, test alt alan adları dahil olmak üzere sayfaların kaynaklarını, söz konusu uygulama için yapılandırdığınız OAuth 2.0 İstemcisinin yetkili JavaScript kaynaklarına eklediğinizden emin olun. Bu işlem Google Cloud Console'da yapılmalıdır.

Hesap bağlanamadı

Hata örneği:

Hesap bağlanamadı

2. Şekil. Hesap bağlanamıyor sorunu.

Bu sorunu gidermek için aşağıdakileri kontrol edin:

  • Yayıncı Merkezi'nde Abonelik Bağlama Hizmet Şartları'nı kabul ettiğinizden emin olun. Bunu yapmak için Abonelik Bağlama ayarlarına gidin ve abonelik bağlama hizmet şartlarını imzalayın'ı tıklayın.
  • Google Hesabı zaten bağlanmışsa aboneliği bağlamayı tekrar denediğinizde bir hata mesajı alırsınız. İstemci tarafı entegrasyon testini tekrar etmeden önce Google Hesabı'ndaki abonelikler sayfasından aboneliğin bağlantısını kaldırmanız gerekir.

Subscription linking API çağrılırken izin hatası

Hata örneği:

Kod 403
Mesaj 'readerrevenuesubscriptionlinking.readerEntitlements.update',
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' kaynağında reddedildi (veya kaynak mevcut olmayabilir)."

Bu sorunu gidermek için aşağıdakileri kontrol edin:

  • Abonelik bağlama kurulumunda belirtilenle aynı projeyi kullandığınızdan emin olun. Yayıncı Merkezi'nde Abonelik Bağlama özelliğini ayarlarken Proje numarasını kullanın. Proje numarasını proje kontrol panelinizden bulabilirsiniz.
  • Projenizde Subscription linking API'nin etkinleştirildiğinden emin olun.
  • Proje Kimlik ve Erişim Yönetimi'nde (IAM) hizmet hesabına, Abonelik Bağlama Yöneticisi olarak rol verildiğinden emin olun. Rol değişikliğinin sistem üzerinden yayılmasının zaman alabileceğini unutmayın. API çağrıları yaparken 403 hatası alırsanız hizmet hesabınızın doğru IAM rolüne sahip olduğunu onayladıktan sonra bile birkaç dakika bekleyip isteğinizi tekrar deneyin.

  • Hangi hizmet hesaplarını kullanmanız gerektiğinden veya bu hesapların gerekli IAM rolüne sahip olup olmadığından emin değilseniz Abonelik Bağlama için ayarladığınız projedeki Politika Analiz Aracı'nı kullanın. Aşağıdaki sorgu parametreleriyle özel sorgu oluşturup çalıştırın:

    Parametre 1 Rol
    Rol Abonelik Bağlama Yöneticisi

  • Subscription linking API'yi çağırırken doğru hizmet hesabı anahtarını kullandığınızdan emin olun. Hizmet hesabı anahtarınızda (JSON dosyası) aşağıdaki özellikleri inceleyin:

    • type: service_account olmalıdır.
    • project_id: Bu değer, Abonelik Bağlama kurulumunda belirtilen Proje numarasının Proje Kimliği olmalıdır.
    • client_email: Proje IAM'sinde, Abonelik Bağlama Yöneticisi rolüyle atanan hizmet hesabı olmalıdır.

  • Erişim jetonunu Google OAuth 2.0 jeton uç noktası (https://oauth2.googleapis.com/token) üzerinden aldıysanız Subscription linking API'leri çağırırken jetonun geçerli olduğundan ve süresinin dolmadığından emin olun. Jetonun geçerliliği sona ererse yeni bir jeton almanız gerekir.

  • REST API'yi kullanıyorsanız Abonelik Bağlama kurulumunda sağladığınız Yayın Kimliği'ni kullandığınızdan emin olun. Örneğin, yayın kimliğiniz example.com ise istek URL'sinde bu kimlik bulunmalıdır.

    • ✅ Yalnızca yapılandırılan yayın kimliğini kullanın: publications/example.com/readers/10078823/entitlements
    • ❌ Abonelik Bağlama yapılandırmasında belirtilenden başka yayın kimliği kullanmayın: publications/example-staging.com/readers/10078823/entitlements
    • ❌ İstekte yayın ürününü dahil etmeyin: publications/example.com:premium/readers/10078823/entitlements

Yararlanma hakkı güncellenirken geçersiz bağımsız değişken hatası oluştu

Hata örneği:

Mesaj Hata: İstekte geçersiz bir bağımsız değişken var

Bu sorunu gidermek için aşağıdakileri kontrol edin:

  • entitlements nesnesini doğru biçimde sağladığınızdan emin olun. Bu örneğe bakın.
  • product_id öğesinin publication_id:product biçiminde olduğundan emin olun.
    • ✅ Geçerli örnek: "product_id":"example.com:basic"
    • ❌ Geçersiz örnek: "product_id":"example.com"

Arama sonuçlarında vurgulanan makaleleri görmemek

Bu sorunu gidermek için aşağıdakileri kontrol edin: