Persyaratan Konektor Partner

Tinjau Ringkasan publikasi untuk memahami manfaat dan tingkat komitmen yang diperlukan untuk memublikasikan konektor. Untuk memublikasikan Konektor Partner, konektor Anda harus memenuhi semua persyaratan yang dijelaskan di bawah.

Apps Script

Sebelum mengirimkan konektor untuk ditinjau, selesaikan langkah-langkah berikut di Apps Script:

1. Bagikan akses lihat project Apps Script Anda kepada:
   • [e-mail]
   • [e-mail]
2. Buat deployment bernama Production dan perbarui deployment Production ke versi kode yang ingin Anda publikasikan.
3. Konfirmasi bahwa Anda telah mengupdate deployment Production ke versi kode yang ingin ditinjau.
4. Pastikan file manifes terlihat di Apps Script. Di sebelah kiri, klik Setelan Project . Centang kotak Tampilkan file manifes "appsscript.json" dalam editor.

Manifes

Sertakan kode berikut dalam manifes konektor Anda dan konfirmasi bahwa project Apps Script Anda dikonfigurasi untuk menampilkan file manifes appsscript.json di editor.

Lihat referensi manifes Konektor Komunitas untuk informasi selengkapnya.

dataStudio

1. description harus memberikan informasi dan petunjuk untuk pemahaman dasar tentang konektor dan cara menggunakannya. Konektor dengan deskripsi yang tidak jelas dan tidak lengkap akan ditolak.
2. addOnUrl harus berupa halaman yang dihosting khusus tentang konektor Anda, sebaiknya dihosting di domain Anda sendiri. Halaman harus menyertakan hal berikut:
   • Kebijakan Privasi dan Persyaratan Penggunaan atau link ke konten ini, di domain yang sama dengan addOnUrl.
   • Detail yang perlu diketahui pengguna untuk menggunakan konektor Anda.
   • Link pendaftaran, jika akun diperlukan untuk menggunakan konektor Anda.
   • Konten sebaiknya dihosting di domain Anda. Hosting di https://sites.google.com/ tidak diizinkan.
   • Lihat contoh halaman dari partner yang sudah ada: Funnel, Supermetrics, CallRail.
3. supportUrl harus berupa halaman yang dihosting untuk mendapatkan dukungan untuk konektor Anda. Ini tidak boleh berupa link email atau mailto.
4. logoUrl harus mengarah ke gambar statis yang dihosting di bawah kontrol Anda. Anda tidak dapat menggunakan gambar yang ditayangkan oleh layanan Google di domain seperti *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com. Menggunakan Google Cloud Storage untuk menyajikan gambar dari domain *.googleapis.com dapat diterima dan merupakan opsi hosting yang direkomendasikan.
   • Konektor dengan ikon animasi akan ditolak. Gunakan gambar statis.
   • Sebaiknya gunakan gambar berukuran minimal 48x48 piksel.
   • Hindari gambar khusus teks yang sulit dibaca saat diperkecil menjadi 48x48 piksel.
5. Isi properti sources dengan semua sumber yang terhubung ke konektor Anda. Lihat Referensi Sumber dalam Manifes untuk mengetahui detailnya.
   • Anda dapat melihat daftar sumber yang ada di Data Registry Repository. Jika sumber yang Anda hubungkan tidak ada di repositori, kirim permintaan penarikan ke Repositori Pendaftaran Data untuk menambahkan sumber. Konektor Anda akan gagal dalam proses peninjauan jika sumber di manifes Anda tidak ada di repositori.
   • Ini adalah metadata tambahan untuk konektor yang akan diindeks untuk fitur penelusuran di galeri. Konektor Anda akan muncul di hasil penelusuran saat pengguna menelusuri sumber tertentu di galeri.
6. Berikan nilai untuk shortDescription, authType, feeType, privacyPolicyUrl, dan termsOfServiceUrl.
7. name harus secara langsung merepresentasikan tujuan konektor. Nama yang jelas akan membantu pengguna menentukan apakah konektor Anda memenuhi kebutuhan mereka. Hindari penggunaan kata konektor dalam nama karena pengguna sudah tahu bahwa mereka sedang melihat konektor.
   • Jangan sertakan karakter khusus atau tidak terlihat dengan maksud menarik perhatian atau berpotensi mengubah posisi penghubung Anda.
8. Jangan gunakan nama singkat untuk Data Studio di mana pun dalam manifes (mis. GDS, DS, dll.).
9. Emoji tidak diizinkan di kolom manifes mana pun (description, shortDescription, name, dll.). Secara umum, jangan sertakan karakter khusus atau tidak terlihat dengan maksud untuk menarik perhatian ke konektor Anda.
10. Jika konektor Anda memiliki skema tetap, buat template laporan untuk konektor Anda dan tambahkan ke manifes. Aktifkan Berbagi melalui link untuk laporan.
    

urlFetchWhitelist

1. Batasi jumlah endpoint yang dipanggil oleh UrlFetchApp hanya pada endpoint yang benar-benar diperlukan untuk fungsi konektor. Tambahkan properti urlFetchWhitelist ke tingkat root manifes Anda. Lihat referensi urlFetchWhitelist untuk mengetahui info selengkapnya.
   
   • Sertakan semua endpoint yang digunakan dengan layanan UrlFetchApp.
   • Jika konektor Anda tidak mengambil resource menggunakan layanan UrlFetchApp, tetapkan urlFetchWhitelist ke daftar kosong [].
   • Jika konektor Anda tidak terhubung ke serangkaian endpoint tetap atau awalan endpoint bervariasi, hilangkan properti urlFetchWhitelist dan berikan detail di kolom formulir Pengecualian untuk urlFetchWhitelist saat mengirimkan permintaan peninjauan.

oauthScopes

1. Tetapkan cakupan OAuth eksplisit dalam manifes. Konektor tanpa cakupan OAuth eksplisit akan ditolak.

Konektor

1. Jika pengguna memerlukan akun untuk menggunakan konektor, pastikan link description atau addOnUrl konektor memberikan petunjuk untuk membantu pengguna membuat akun.
2. Konektor Anda tidak boleh dalam status belum selesai atau beta. Anda harus memublikasikan konektor yang lengkap dan berfungsi. Anda dapat memperbarui konektor kapan saja, tetapi deployment produksi yang dirilis kepada pengguna harus diuji dan memiliki fitur lengkap.
3. Berikan pesan error yang bermakna dan dapat ditindaklanjuti kepada pengguna saat pengguna mengalami Error internal konektor. Hal ini mencakup kasus saat pengguna memberikan input yang tidak valid/kosong pada konfigurasi.
4. Link shortDescription, description, addOnUrl, link supportUrl, dan halaman OAuth (jika ada) tidak boleh mengandung kesalahan ejaan dan tata bahasa.
5. shortDescription tidak boleh berisi URL.
6. Gunakan metode autentikasi yang disediakan oleh getAuthType(). Jangan meminta kredensial melalui getConfig().
   
7. Selesaikan proses Verifikasi Klien OAuth. Verifikasi wajib dilakukan untuk semua konektor, terlepas dari metode autentikasi di getAuthType(). Proses verifikasi berbeda dengan proses peninjauan konektor dan ditangani oleh tim yang berbeda, bukan Data Studio. Lihat FAQ Verifikasi OAuth API untuk mengetahui info selengkapnya. Konektor Anda akan ditolak jika proses Verifikasi Klien OAuth tidak selesai.
   
   • Selama proses verifikasi OAuth, tambahkan cakupan OAuth yang diperlukan konektor Anda sebagai bagian dari konfigurasi layar izin OAuth. Jika Anda gagal menambahkan semua cakupan yang diperlukan, Anda mungkin lolos proses verifikasi OAuth, tetapi konektor Anda akan tetap menampilkan Layar aplikasi yang belum diverifikasi. Tindakan ini akan menyebabkan kegagalan proses verifikasi Partner Connector.
     Otorisasi dan uji konektor Anda menggunakan akun baru setelah lulus proses verifikasi OAuth untuk memastikan Layar aplikasi yang belum diverifikasi tidak ditampilkan kepada pengguna Anda.
8. Pastikan Anda mematuhi Persyaratan Layanan Galeri Data Studio (Pengirim).

Setelah Anda memenuhi semua persyaratan, klik tombol berikut untuk meminta peninjauan konektor Anda:

Memublikasikan Konektor Partner