Sebagai administrator, Anda dapat menambahkan dan mengonfigurasi beberapa aplikasi pihak ketiga dengan file nilai yang dipisahkan koma (CSV). Dari konsol Google Admin, Anda dapat mendownload template CSV kosong. Atau, mendownload file CSV yang berisi semua aplikasi pihak ketiga yang sudah ada di konsol Admin Anda untuk diedit atau ditambahkan.
Sebelum Anda memulai
- Ukuran maksimum file CSV adalah 10 MB.
- Saat Anda mengupload file, informasi di kolom Jenis, ID, Akses, dan Unit Org akan menggantikan informasi yang ada di konsol Admin Anda.
- Untuk informasi yang tidak ingin diubah, Anda dapat menghapus kolom, membiarkan informasi dalam kolom apa adanya, atau menghapus informasi tersebut.
- Jika Anda menghapus semua informasi dari kolom, tetapi tidak menghapus kolom di file CSV, informasi yang ada tidak akan dihapus saat Anda mengupload file tersebut.
- Jika Anda tidak ingin mengedit aplikasi tertentu, Anda dapat melewati baris dalam spreadsheet atau menghapusnya. Jika Anda menghapus aplikasi dari file, aplikasi tersebut tidak akan dihapus.
Menambahkan & mengonfigurasi aplikasi dari file CSV
Langkah 1: Download file CSV
-
Login ke Konsol Google Admin.
Login menggunakan akun yang memiliki hak istimewa administrator super (yang tidak diakhiri dengan @gmail.com).
-
Di konsol Admin, buka Menu
Keamanan
Kontrol data dan akses
Anda harus login sebagai administrator super untuk tugas ini. - (Opsional) Untuk mengonfigurasi aplikasi yang telah mengakses data Google saja, klik Lihat daftar untuk Aplikasi yang diakses.
- Klik Daftar update massal, lalu pilih opsi:
- Untuk mendownload template CSV kosong, klik Download Template Kosong.
- Untuk mendownload file CSV yang berisi aplikasi pihak ketiga yang sudah tercantum di konsol Admin Anda, klik Download Aplikasi yang Dikonfigurasi atau Download Aplikasi yang Diakses. Saat download selesai, klik Download CSV. Anda mungkin harus mengklik Tugas
terlebih dahulu.
- Buka file CSV tersebut di aplikasi spreadsheet, seperti Google Spreadsheet atau Microsoft Excel.
File memiliki kolom untuk atribut setiap aplikasi Anda yang dikonfigurasi.
Langkah 2: Masukkan informasi aplikasi & simpan file
- Untuk setiap aplikasi yang ingin Anda konfigurasi, masukkan informasi dalam kolom di spreadsheet:
- (Opsional) Nama aplikasi—Masukkan nama aplikasi. Perubahan yang Anda lakukan pada nama aplikasi dalam file CSV tidak akan diperbarui di konsol Admin.
- Jenis—Masukkan Android, iOS, atau aplikasi web.
- ID—Untuk aplikasi web, masukkan client ID OAuth yang dikeluarkan untuk aplikasi. Untuk aplikasi Android dan iOS, masukkan client ID OAuth atau ID paket atau paket yang digunakan aplikasi di Google Play atau Apple App Store.
- Akses—Masukkan tepercaya, diblokir, terbatas, atau tidak dikonfigurasi (membatalkan konfigurasi aplikasi di unit organisasi yang ditetapkan di Unit Org).
- Unit Org—Masukkan garis miring ('/') untuk menerapkan setelan akses aplikasi ke seluruh domain Anda. Untuk menerapkan setelan akses ke unit organisasi tertentu, tambahkan baris ke spreadsheet untuk setiap unit organisasi, dengan mengulangi Nama aplikasi, Jenis, dan ID. Masukkan setelan Akses yang diinginkan, dan di Unit Org, masukkan jalur dan nama lengkap (misalnya '/org_unit_1/sub_unit_1').
- Setelah Anda melengkapi spreadsheet, simpan sebagai file CSV (.csv).
Langkah 3: Upload file
- Di konsol Admin, klik Lampirkan File CSV. Anda mungkin harus mengklik Daftar update massal terlebih dahulu.
- Cari dan lampirkan file CSV.
- Klik Upload.
Anda dapat meninjau progres upload. Setelah selesai, Anda akan menerima email laporan.
Jika terjadi error, masukkan informasi yang tidak lengkap, lalu upload file lagi. Jika terjadi error saat proses, download file log dari daftar Tugas Anda. Untuk mengetahui informasi selengkapnya, buka Menyelesaikan error (di bagian bawah halaman ini).
Mengatasi error
Error saat mengupload file CSV Anda
| Error | Penyebab & solusi |
|---|---|
| File kosong | File tidak berisi informasi apa pun. |
| Format file salah atau kolom: nama kolom tidak valid. | Kolom dalam file Anda harus berjudul Nama Aplikasi, Jenis, ID, Status Verifikasi, Pengguna, Layanan yang Diminta, Akses, Layanan yang Diminta dengan Cakupan, dan Unit Org. |
| Kolom Nama kolom tidak ada. | Kolom yang wajib diisi tidak ada. Kolom yang wajib diisi adalah Jenis, ID, Akses, dan Unit Org. |
| Baris nn: Nama kolom kosong | Di baris yang disebutkan, ada kolom yang wajib diisi tetapi kosong. Misalnya, Anda akan melihat error Baris 2: "Akses" kosong jika Anda tidak memasukkan tingkat akses aplikasi. Tambahkan informasi tersebut, lalu coba lagi. |
| Ukuran file tidak boleh lebih dari 10 MB. | Ukuran file CSV lebih dari 10 MB. Buka file dan bagi tabel menjadi beberapa file terpisah. Simpan setiap file sebagai file CSV. Pastikan Anda menyertakan baris judul kolom di semua file CSV. |
| Baris nn: Jumlah kolom salah | Jumlah kolom tidak cocok dengan jumlah kolom header untuk suatu baris. Periksa detail baris, lalu coba lagi. |
| Tidak dapat membaca file. Periksa dan coba lagi. | Terjadi error saat membaca file. Periksa file dan coba lagi. |
| Tidak dapat membaca header. Periksa dan coba lagi. | File CSV yang diupload berisi header yang tidak valid. Header dalam file Anda harus berjudul Nama Aplikasi, Jenis, ID, Status Verifikasi, Pengguna, Layanan yang Diminta, Akses, Layanan yang Diminta dengan Cakupan, dan Unit Org. Periksa header, lalu coba lagi. |
| File memiliki kolom: nama kolom duplikat. | File CSV yang diupload memiliki kolom duplikat. Hapus kolom duplikat, lalu coba lagi. |
| Jenis file tidak valid. Upload file CSV saja. | Jenis file yang diupload tidak dalam format CSV. Simpan sebagai file CSV, lalu coba lagi. |
| Baris nn: Tidak dapat diurai | Baris dalam file CSV tidak dapat diurai. Periksa detail baris, lalu coba lagi. |
| Baris nn: Jenis Aplikasi Tidak Valid | Baris dalam file memiliki jenis aplikasi yang tidak valid. Jenis aplikasi yang diterima adalah Android, iOS, atau aplikasi web. |
| Baris nn: Status tidak valid | Baris dalam file memiliki informasi yang tidak valid untuk Akses. Kolom Akses harus memiliki status tepercaya, diblokir, atau terbatas. Perbarui kolom, lalu coba lagi. |
| Baris nn: Entri duplikat | Anda memiliki baris duplikat. Hapus baris duplikat, lalu coba lagi. |
| Baris nn: Error tidak diketahui | Terjadi error yang tidak diketahui saat mengurai baris. Periksa detail baris, lalu coba lagi. |
Error di file log
| Error | Penyebab & solusi |
|---|---|
| ACTION FAILED: Validation | Entri berisi karakter yang tidak didukung. Periksa file dan coba lagi. |
| ACTION FAILED: UNKNOWN ERROR | Terjadi error sementara. Upload file CSV lagi atau upload item dalam batch yang lebih kecil. |
| INVALID_APP_IDENTIFIER |
Satu atau beberapa ID aplikasi yang Anda masukkan salah.
|
| INVALID_ORG_UNIT_PATH | Unit org yang Anda masukkan tidak valid. Perbarui unit organisasi, lalu coba lagi. |
| CONFIGURATION_LIMIT_REACHED | Anda telah mencapai atau melampaui batas 15.000 aplikasi yang dikonfigurasi. Jumlah total aplikasi pihak ketiga yang dapat Anda konfigurasi (secara massal dan individual) adalah 15.000. Hapus baris tambahan, lalu coba lagi. |
| FIRST_PARTY_APP_ERROR | ID aplikasi bukan milik aplikasi pihak ketiga dan tidak dapat dikonfigurasi. Hapus aplikasi dari file, lalu coba lagi. |
Google, Google Workspace, serta merek dan logo yang terkait adalah merek dagang Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang terkait.
