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 ini.

Apps Script

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

  1. Bagikan akses lihat project Apps Script Anda dengan:
  2. Buat deployment bernama Production dan update 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 Project Settings . Pilih kotak centang Tampilkan file manifes "appsscript.json" dalam editor.

Manifes

Sertakan baris berikut dalam manifes konektor Anda dan pastikan project Apps Script Anda dikonfigurasi untuk menampilkan file manifes appsscript.json di editor.

Lihat referensi manifes Konektor Komunitas untuk mengetahui informasi selengkapnya.

dataStudio

  1. description harus memberikan informasi dan petunjuk untuk mendapatkan 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 tersebut harus menyertakan hal berikut:
    • Kebijakan Privasi dan Persyaratan Penggunaan atau link ke konten ini, pada domain yang sama dengan addOnUrl.
    • Detail yang perlu diketahui pengguna untuk menggunakan konektor Anda.
    • Link pendaftaran, jika akun diperlukan untuk menggunakan konektor Anda.
    • Sebaiknya konten yang dihosting di domain Anda. Hosting di https://sites.google.com/ tidak diizinkan.
    • Lihat contoh halaman dari partner yang ada: Funnel, Supermetrics, CallRail.
  3. supportUrl harus berupa halaman yang dihosting untuk mendapatkan dukungan bagi konektor Anda. Ini tidak boleh berupa email atau link mailto.
  4. logoUrl harus mengarah ke gambar statis yang dihosting di bawah kontrol Anda. Anda tidak dapat menggunakan gambar yang ditampilkan oleh layanan Google di domain seperti *.gstatic.com, *.ggpht.com, *.google.com, *.googleusercontent.com. Penggunaan Google Cloud Storage untuk menyalurkan gambar dari domain *.googleapis.com dapat diterima dan merupakan opsi hosting yang direkomendasikan.
    • Konektor dengan ikon animasi akan ditolak. Gunakan gambar statis.
    • Sebaiknya gunakan minimal gambar berukuran 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 Sumber dalam referensi Manifes untuk mengetahui detailnya.
    • Anda dapat melihat daftar sumber yang ada di Repositori Data Registry. Jika sumber yang Anda hubungkan tidak ada di repositori, kirim permintaan pull ke Repositori Data Registry untuk menambahkan sumber. Konektor Anda akan gagal dalam proses peninjauan jika sumber dalam 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 mewakili 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 yang tidak terlihat dengan tujuan menarik perhatian atau berpotensi mengubah posisi konektor Anda.
  8. Jangan gunakan nama singkat untuk Looker Studio di mana pun dalam manifes (misalnya GDS, DS, dll.).
  9. Emoji tidak diizinkan di kolom manifes (description, shortDescription, name, dll.). Secara umum, jangan sertakan karakter khusus atau yang tidak terlihat 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 ke jumlah 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 kumpulan endpoint tetap atau awalan endpoint bervariasi, hapus properti urlFetchWhitelist dan berikan detail di kolom formulir Exception for urlFetchAllowed saat mengirim 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 konektor description atau link addOnUrl memberikan petunjuk untuk membantu pengguna membuatnya.
  2. Konektor Anda tidak boleh dalam status belum selesai atau beta. Anda harus memublikasikan konektor yang lengkap dan fungsional. Anda dapat memperbarui konektor kapan saja, tetapi deployment produksi yang dirilis kepada pengguna harus diuji dan fitur selesai.
  3. Memberikan pesan error yang bermakna dan dapat ditindaklanjuti kepada pengguna saat pengguna mengalami Error internal konektor. Hal ini termasuk kasus saat pengguna memberikan input yang tidak valid/kosong saat konfigurasi.
  4. shortDescription, description, link addOnUrl, link supportUrl, dan halaman OAuth (jika ada) harus bebas dari 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 ini wajib dilakukan untuk semua konektor, terlepas dari metode autentikasi di getAuthType(). Proses verifikasi adalah proses yang berbeda dengan peninjauan konektor dan ditangani oleh tim terpisah, bukan Looker Studio. Baca FAQ Verifikasi OAuth API untuk mengetahui info selengkapnya. Konektor Anda akan ditolak jika proses Verifikasi Klien OAuth tidak selesai.
  8. Pastikan Anda mematuhi Persyaratan Layanan Galeri Looker Studio (Pengirim).

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

Publikasikan Konektor Partner