İş Ortağı Bağlayıcısı gereksinimleri

Bağlayıcı yayınlamanın avantajlarını ve gerekli taahhüt düzeyini anlamak için Yayınlama özeti'ni inceleyin. Partner Connector yayınlamak için bağlayıcınızın aşağıda açıklanan tüm gereksinimleri karşılaması gerekir.

Apps Komut Dosyası

Bağlayıcınızı incelemeye göndermeden önce Apps Komut Dosyası'nda aşağıdakileri tamamlayın:

  1. Apps Komut Dosyası projenizin görüntüleme erişimini aşağıdakilerle paylaşın:
  2. Production adlı bir dağıtım oluşturun ve Production dağıtımını, yayınlamayı istediğiniz kod sürümüne güncelleyin.
  3. Production dağıtımını, incelenmesini istediğiniz kodun sürümüne güncellediğinizi onaylayın.
  4. Manifest dosyasının Apps Komut Dosyası'nda görünür olduğunu doğrulayın. Sol tarafta Proje Ayarları'nı tıklayın. "appsscript.json" manifest dosyasını düzenleyicide göster onay kutusunu işaretleyin.

Manifest

Bağlayıcınızın manifest dosyasına aşağıdakileri ekleyin ve Apps Komut Dosyası projenizin, düzenleyicide appsscript.json manifest dosyasını gösterecek şekilde yapılandırıldığını onaylayın.

Daha fazla bilgi için Community Connector manifest referansını görüntüleyin.

dataStudio

  1. description , bağlayıcı ve bağlayıcının nasıl kullanılacağı hakkında temel bir anlayışa yönelik bilgi ve talimatlar sağlamalıdır. Belirsiz ve eksik açıklamalar içeren bağlayıcılar reddedilir.
  2. addOnUrl , tercihen kendi alanınızda barındırılan, bağlayıcınız hakkında barındırılan özel bir sayfa olmalıdır. Sayfa şunları içermelidir:
    • addOnUrl ile aynı alanda bulunan bir Gizlilik Politikası ve Kullanım Şartları veya bu içeriğin bağlantısı.
    • Kullanıcının bağlayıcınızı kullanması için bilmesi gereken ayrıntılar.
    • Kaydolma bağlantısı (Bağlayıcınızı kullanmak için bir hesap gerekiyorsa).
    • Tercihen alan adınızda barındırılan içerik. https://sites.google.com/ alanında barındırılmasına izin verilmez.
    • Mevcut iş ortaklarının örnek sayfalarını inceleyin: Dönüşüm hunisi, Süper metrikler, CallRail.
  3. supportUrl , bağlayıcınız için destek almak üzere barındırılan bir sayfa olmalıdır. Bu, bir e-posta veya mailto bağlantısı olamaz.
  4. logoUrl , kontrolünüz altında barındırılan statik bir resmi işaret etmelidir. Google hizmetleri tarafından sunulan resimleri *.gstatic.com, *.ggpht.com, *.google.com ve*.googleusercontent.com gibi alanlarda kullanamazsınız. *.googleapis.com alanından görüntü sunmak için Google Cloud Storage'ı kullanmak kabul edilir ve önerilen bir barındırma seçeneğidir.
    • Animasyonlu simgeler içeren bağlayıcılar reddedilir. Statik resimler kullanın.
    • En az 48x48 piksel boyutunda bir resim kullanmanız önerilir.
    • 48x48 piksele küçültüldüğünde okunması zor olan, yalnızca metin içeren resimlerden kaçının.
  5. sources özelliğini, bağlayıcınızın bağlandığı tüm kaynaklarla doldurun. Ayrıntılar için Manifest referansındaki kaynaklar bölümüne bakın.
    • Mevcut kaynak listesini Veri Kaydı Deposu'nda görüntüleyebilirsiniz. Bağlandığınız kaynak, depoda mevcut değilse kaynağı eklemek için Veri Kaydı Deposu'na bir çekme isteği gönderin. Manifest'inizdeki kaynaklar kod deposunda yoksa bağlayıcınız inceleme sürecinde başarısız olur.
    • Bu, galerideki arama özelliği için dizine eklenecek bağlayıcıya yönelik ek meta veridir. Kullanıcılar galeride belirli bir kaynağı aradığında bağlayıcınız arama sonuçlarında gösterilir.
  6. shortDescription, authType, feeType, privacyPolicyUrl ve termsOfServiceUrl için değerler sağlayın.
  7. name doğrudan bağlayıcının amacını temsil etmelidir. Net bir ad, kullanıcıların bağlayıcınızın ihtiyaçlarını karşılayıp karşılamadığını belirlemesine yardımcı olur. Kullanıcılar bir bağlayıcıya baktıklarını zaten bildikleri için adda bağlayıcı kelimesini kullanmaktan kaçının.
    • Bağlayıcınızın konumuna dikkat çekmek veya muhtemelen konumunu değiştirmek amacıyla özel veya görünmez karakterler kullanmayın.
  8. Manifestin hiçbir yerinde (ör. GDS, DS vb.) Looker Studio için kısaltılmış adlar kullanmayın.
  9. Manifest alanlarında (description, shortDescription, name vb.) emojilere izin verilmez. Genel olarak, bağlayıcınıza dikkat çekmek amacıyla özel veya görünür olmayan karakterler eklemeyin.
  10. Bağlayıcınızın sabit bir şeması varsa bağlayıcınız için bir rapor şablonu oluşturun ve bunu manifest dosyasına ekleyin. Rapor için Bağlantıyla paylaşma'yı etkinleştirin.

urlFetchWhitelist

  1. UrlFetchApp tarafından çağrılan uç noktaların sayısını, bağlayıcı işlevi için kesinlikle gerekli olan uç noktalarla sınırlandırın. urlFetchWhitelist özelliğini manifest dosyanızın kök düzeyine ekleyin. Daha fazla bilgi için urlFetchWhitelist referansını görüntüleyin.
    • UrlFetchApp hizmetiyle kullanılan tüm uç noktaları dahil edin.
    • Bağlayıcınız UrlFetchApp hizmetini kullanarak kaynakları getirmiyorsa urlFetchWhitelist öğesini boş bir [] listesine ayarlayın.
    • Bağlayıcınız bir dizi sabit uç noktaya bağlanmazsa veya uç nokta öneki değişirse inceleme isteğini gönderirken urlFetchWhitelist özelliğini çıkarın ve urlFetchWhitelist form alanına ayrıntıları girin.

oauthScopes

  1. Manifest'te açık OAuth kapsamları belirleyin. Açık OAuth kapsamları olmayan bağlayıcılar reddedilir.

Bağlayıcı

  1. Kullanıcının bağlayıcıyı kullanmak için hesaba ihtiyacı varsa bağlayıcının description veya addOnUrl bağlantısının kullanıcının hesap oluşturmasına yardımcı olacak talimatları sağladığından emin olun.
  2. Bağlayıcınız tamamlanmamış veya beta durumunda olamaz. Eksiksiz ve işlevsel bir bağlayıcı yayınlamanız gerekir. Bağlayıcınızı istediğiniz zaman güncelleyebilirsiniz ancak kullanıcılara sunulan üretim dağıtımı test edilip özelliğin eksiksiz olması gerekir.
  3. Kullanıcılar Bağlayıcı dahili hatasıyla karşılaştığında kullanıcılara anlamlı ve uygulanabilir hata mesajları sağlayın. Buna, kullanıcının yapılandırma sırasında geçersiz/boş giriş sağladığı durumlar da dahildir.
  4. shortDescription, description, addOnUrl bağlantısı, supportUrl bağlantısı ve OAuth sayfası (varsa) yazım ve dil bilgisi hatası içermemelidir.
  5. shortDescription URL içeremez.
  6. getAuthType() tarafından sağlanan kimlik doğrulama yöntemlerini kullanın. Kimlik bilgilerini getConfig() üzerinden istemeyin.
  7. OAuth İstemci Doğrulaması işlemini tamamlayın. Doğrulama, getAuthType() içindeki kimlik doğrulama yönteminden bağımsız olarak tüm bağlayıcılar için zorunludur. Doğrulama süreci, bağlayıcının incelemesinden farklı bir süreçtir ve Looker Studio tarafından değil, ayrı bir ekip tarafından yürütülür. Daha fazla bilgi için OAuth API Doğrulamasıyla İlgili SSS bölümüne bakın. OAuth İstemci Doğrulaması süreci tamamlanmazsa bağlayıcınız reddedilir.
    • OAuth doğrulama süreci sırasında, OAuth izin ekranı yapılandırmasının bir parçası olarak bağlayıcınızın gerekli OAuth kapsamlarını ekleyin. Gerekli tüm kapsamları ekleyemezseniz OAuth doğrulama işleminden geçebilirsiniz, ancak bağlayıcınız Doğrulanmamış uygulama ekranı göstermeye devam eder. Bu, İş Ortağı Bağlayıcı doğrulama sürecinin başarısız olmasına neden olur.
      OAuth doğrulama işlemini geçtikten sonra, Doğrulanmamış uygulama ekranı'nın kullanıcılarınıza gösterilmediğinden emin olmak için bağlayıcınızı yeni bir hesap kullanarak yetkilendirin ve test edin.
  8. Looker Studio Galerileri Hizmet Şartları'na (Gönderen) uyduğunuzdan emin olun.

Tüm gereksinimleri karşıladıktan sonra, bağlayıcınızın incelenmesini istemek için aşağıdaki düğmeyi tıklayın:

İş Ortağı Bağlayıcınızı yayınlama