Penyiapan teknis

Sebelum memulai

Sebelum memulai, Anda memerlukan hal berikut:

• Akses admin super ke domain reseller Anda. Untuk mengetahui informasi selengkapnya, lihat cara mengakses Cloud Channel API.

• Akses ke konsol Google Cloud dan Partner Sales Console.

Langkah 1: Siapkan Partner Sales Console

Sebelum dapat menggunakan API, Anda harus menyetujui persyaratan dan ketentuan platform Layanan Saluran.

Login ke Partner Sales Console setidaknya sekali sebagai administrator domain reseller. Saat pertama kali login, Anda harus menyetujui persyaratan layanan reseller, jika berlaku. Jika Anda menyetujui persyaratan layanan tertentu secara offline, langkah ini tidak berlaku untuk Anda.

Anda dapat menyetujui persyaratan layanan tambahan di halaman Persyaratan Partner Sales Console.

Catatan: Anda memerlukan ID Akun, yang dapat ditemukan di halaman Setelan Partner Sales Console, untuk integrasi API.

Langkah 2: Konfigurasikan project Google Cloud Anda

Untuk menggunakan Google API, Anda harus memiliki project Google Cloud.

Membuat project Google Cloud

Untuk membuat project, buka area Projects di konsol Google Cloud, lalu klik Create Project.

Untuk petunjuk yang lebih mendetail tentang cara membuat project, dan untuk daftar praktik terbaik, lihat panduan Membuat dan mengelola project.

Sebagian besar reseller membuat project Google Cloud di organisasi Google Cloud utama mereka, bukan di domain reseller. Akses data dari domain reseller diberikan dengan menyiapkan delegasi seluruh domain untuk mengizinkan akun layanan mengakses data dari domain reseller.

Beri nama deskriptif pada project. Project ID adalah ID arbitrer yang tidak memengaruhi kemampuan Anda untuk memanggil Cloud Channel API.

Mengaktifkan API

Buka bagian Library API di konsol Google Cloud dan aktifkan Cloud Channel API.

Membuat akun layanan

Untuk membuat akun layanan, buka halaman Akun layanan.

Buka halaman Service accounts

Catatan: Kunci akun layanan akan berisiko keamanan jika tidak dikelola dengan benar. Anda harus memilih alternatif yang lebih aman untuk kunci akun layanan jika memungkinkan. Jika harus mengautentikasi dengan kunci akun layanan, Anda bertanggung jawab atas keamanan kunci pribadi dan atas operasi lainnya yang dijelaskan oleh Praktik terbaik untuk mengelola kunci akun layanan. Jika Anda tidak dapat membuat kunci akun layanan, pembuatan kunci akun layanan mungkin dinonaktifkan untuk organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Mengelola resource organisasi yang aman secara default.

1. Klik Buat akun layanan.
2. Masukkan Nama akun layanan (dan Deskripsi akun layanan opsional), lalu klik Buat.
3. Klik Lanjutkan untuk melewati opsi Beri akun layanan akses ke project.
4. Lewati bagian Beri pengguna akses ke akun layanan ini dan klik Selesai untuk menyelesaikan pembuatan akun.

Setelah membuat akun, buat kunci akun layanan:

1. Di konsol Google Cloud, klik alamat email untuk akun layanan yang telah Anda buat.
2. Klik Kunci.
3. Klik Tambahkan kunci, lalu klik Buat kunci baru.

4. Klik Buat. File kunci JSON akan didownload ke komputer Anda.

   Pastikan Anda menyimpan file kunci dengan aman karena file tersebut dapat digunakan untuk melakukan autentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini sesuai keinginan Anda.

5. Klik Close.

Anda dapat menghapus dan membuat file kunci pribadi dari halaman Akun layanan.

Langkah 3: Berikan otorisasi ke akun layanan untuk domain reseller

Anda memerlukan Client ID akun layanan untuk bagian ini. Dari menu Tindakan, pilih Kelola detail dan salin ID Unik Anda.

Buka Halaman delegasi seluruh domain menggunakan akun superadmin domain reseller Anda.

• Klik Tambahkan baru, lalu masukkan ID akun layanan Anda di kolom Client ID.
• Masukkan https://www.googleapis.com/auth/apps.order di kolom Cakupan OAuth.
• Klik Authorize untuk mengizinkan akun layanan Anda menggunakan Cloud Channel API dalam konteks akun Layanan Channel Anda.

Catatan: Jika menggunakan API tambahan dalam integrasi akhir, Anda mungkin memiliki lebih dari satu cakupan untuk klien akun layanan.

Kemudian, klik Authorize agar akun layanan Anda dapat menggunakan Cloud Channel API dalam konteks akun Layanan Saluran Anda.

Catatan: Anda mungkin harus mengaktifkan lebih banyak API dan menambahkan lebih banyak cakupan di codelab lain. Integrasi akhir Anda mungkin memiliki lebih dari satu cakupan untuk klien akun layanan Anda.

Langkah berikutnya

Setelah memiliki integrasi teknis awal, Anda dapat menemukan API dengan membaca dokumentasi Cloud Channel API.

Catatan: Jika Anda juga memiliki Partner Sales Console Pengujian, ikuti langkah satu hingga empat dengan domain reseller pengujian Anda. Pastikan untuk membuat project terpisah karena Google API memiliki kuota per project. Membagikan project di seluruh lingkungan dapat menyebabkan akun pengujian Anda memengaruhi kuota di akun produksi.