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

Bir bağlayıcı yayınlamanın avantajlarını ve gerekli bağlılık düzeyini anlamak için Yayınlama özeti başlıklı makaleyi inceleyin. İş Ortağı Bağlayıcısı yayınlamak için bağlayıcınızın aşağıda açıklanan tüm koşulları karşılaması gerekir.

Apps Komut Dosyası

Bağlayıcınızı incelemeye göndermeden önce Apps Script'te 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ı planladığınız kod sürümüne güncelleyin.
  3. Production dağıtımını, incelenmesini istediğiniz kod sürümüne güncellediğinizi onaylayın.
  4. Manifest dosyasının Apps Komut Dosyası'nda göründüğünü onaylayın. Sol tarafta Proje Ayarları'nı tıklayın. "appsscript.json" manifest dosyasını düzenleyicide göster onay kutusunu seçin.

Manifest

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

Daha fazla bilgi için Topluluk Bağlayıcı manifest referansını inceleyin.

dataStudio

  1. description , bağlayıcıyı ve nasıl kullanılacağını temel düzeyde anlamak için bilgi ve talimatlar sağlamalıdır. Belirsiz ve eksik açıklamalara sahip bağlayıcılar reddedilir.
  2. addOnUrl , bağlayıcınızla ilgili özel bir barındırılan sayfa olmalıdır. Tercihen kendi alanınızda barındırılmalıdır. Sayfada şunlar bulunmalıdır:
    • addOnUrl ile aynı alan adında bir Gizlilik Politikası ve Kullanım Şartları veya bu içeriğe yönlendiren bir bağlantı.
    • Kullanıcının bağlayıcınızı kullanmak için bilmesi gereken ayrıntılar.
    • Bağlayıcınızı kullanmak için hesap gerekliyse kayıt bağlantısı.
    • Tercihen alanınızda barındırılan içerik. https://sites.google.com/ üzerinde barındırmaya izin verilmez.
    • Mevcut iş ortaklarının örnek sayfalarına göz atın: Funnel, Supermetrics, CallRail.
  3. supportUrl , bağlayıcınız için destek almak üzere barındırılan bir sayfa olmalıdır. Bu, e-posta veya mailto bağlantısı olamaz.
  4. logoUrl , kontrolünüzde barındırılan bir statik resmi işaret etmelidir. Google hizmetleri tarafından sunulan resimleri *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com gibi alanlarda kullanamazsınız. *.googleapis.com alanından resim yayınlamak için Google Cloud Storage'ı kullanmak kabul edilebilir 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 piksellik bir resim kullanmanız önerilir.
    • 48x48 piksel boyutuna küçültüldüğünde okunması zor olan yalnızca metin içeren resimler kullanmayın.
  5. sources mülkünü, 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 Kayıt Defteri Deposu'nda görüntüleyebilirsiniz. Bağlandığınız kaynak, depoda yoksa kaynağı eklemek için veri kayıt deposuna pull isteği gönderin. Manifest dosyanızdaki kaynaklar depoda yoksa bağlayıcınız inceleme sürecini geçemez.
    • Bu, galerideki arama özelliği için dizine eklenecek bağlayıcıya ait ek meta verilerdir. 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 , bağlayıcının amacını doğrudan 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ı bildiğinden, adında bağlayıcı kelimesini kullanmayın.
    • Bağlayıcınızın konumuna dikkat çekmek veya bağlayıcınızın konumunu değiştirmek amacıyla özel ya da görünür olmayan karakterler eklemeyin.
  8. Manifestin hiçbir yerinde Data Studio için kısaltılmış adlar (ör. GDS, DS vb.) kullanmayın.
  9. Manifest alanlarında emoji'lere izin verilmez (description, shortDescription, name vb.). 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 manifeste ekleyin. Rapor için Bağlantı ile paylaşım'ı etkinleştirin.

urlFetchWhitelist

  1. UrlFetchApp tarafından çağrılan uç nokta sayısını, konnektör işlevselliği için kesinlikle gerekli olanlarla sınırlayın. urlFetchWhitelist özelliğini manifest dosyanızın kök düzeyine ekleyin. Daha fazla bilgi için urlFetchWhitelist referansını inceleyin.
    • UrlFetchApp hizmetiyle kullanılan tüm uç noktaları ekleyin.
    • Bağlayıcınız kaynakları UrlFetchApp hizmetini kullanarak getirmiyorsa urlFetchWhitelist değerini boş liste [] olarak ayarlayın.
    • Bağlayıcınız sabit bir uç nokta grubuna bağlanmıyorsa veya uç nokta öneki değişiyorsa urlFetchWhitelist özelliğini atlayın ve inceleme isteğini gönderirken urlFetchWhitelist için istisna form alanında ayrıntıları belirtin.

oauthScopes

  1. Manifest dosyasında açık OAuth kapsamları ayarlayın. 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 bir hesaba ihtiyacı varsa bağlayıcı veya description 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 olmamalıdır. 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ının test edilmiş ve tüm özelliklerinin tamamlanmış olması gerekir.
  3. Kullanıcılar Bağlayıcı dahili hatasıyla karşılaştığında onlara anlamlı ve uygulanabilir hata mesajları gösterin. Buna, kullanıcının yapılandırma sırasında geçersiz/boş giriş sağladığı durumlar dahildir.
  4. shortDescription, description, addOnUrl bağlantısı, supportUrl bağlantısı ve OAuth sayfası (varsa) yazım ve dilbilgisi hatalarından arındırılmış olmalıdır.
  5. shortDescription URL içeremez.
  6. getAuthType() tarafından sağlanan kimlik doğrulama yöntemlerini kullanın. getConfig() üzerinden kimlik bilgisi istemeyin.
  7. OAuth istemci doğrulama sürecini 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ı incelemesinden farklı bir süreçtir ve Data 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 başlıklı makaleyi inceleyin. OAuth istemci doğrulama süreci tamamlanmazsa bağlayıcınız reddedilir.
  8. Data Studio Galleries Hizmet Şartları (Gönderen)'na uyduğunuzdan emin olun.

Tüm koşulları 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