Memulai Service Management API

Halaman ini menjelaskan cara menyiapkan lingkungan pengembangan Anda agar berfungsi dengan Service Management API. Pendekatan paling sederhana untuk menggunakan Service Management API (selain hanya menggunakan UI web Google Cloud Console), dan rekomendasi kami untuk sebagian besar kasus penggunaan operasional, adalah melalui antarmuka command line gcloud. Jika Anda perlu memprogram menggunakan Service Management API, sebaiknya gunakan salah satu library klien yang kami sediakan. Untuk bereksperimen dengan API, Anda dapat mengikuti petunjuk penyiapan alternatif di bawah ini dan menggunakan perintah curl untuk bermain dengan API tanpa menyiapkan lingkungan pengembangan aplikasi secara lengkap.

Catatan: Jika Anda membuat layanan menggunakan Cloud Endpoints, Anda harus mengikuti Panduan memulai endpoint yang relevan untuk mengetahui cara menyiapkan dan mulai menggunakan Service Management API untuk Cloud Endpoints.

Penyiapan menggunakan gcloud

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Aktifkan API Service Management.

   Mengaktifkan API

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

6. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

7. Aktifkan API Service Management.

   Mengaktifkan API

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

Penyiapan untuk memanggil API secara langsung

Bagian ini menjelaskan langkah-langkah dasar yang diperlukan untuk menyiapkan lingkungan lokal Anda untuk bereksperimen dengan Service Management API menggunakan perintah curl. API ini ditujukan bagi developer yang perlu melakukan pemrograman terhadap Service Management API.

Penyiapan awal

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Buat atau pilih project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   • Membuat project Google Cloud:

     gcloud projects create PROJECT_ID

     Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

   • Pilih project Google Cloud yang Anda buat:

     gcloud config set project PROJECT_ID

     Ganti PROJECT_ID dengan nama project Google Cloud Anda.

5. Aktifkan API Service Management:

   gcloud services enable servicemanagement.googleapis.com

6. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

   • Replace PROJECT_ID with your project ID.

   • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

   • Replace ROLE with each individual role.
7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Buat atau pilih project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   • Membuat project Google Cloud:

     gcloud projects create PROJECT_ID

     Ganti PROJECT_ID dengan nama untuk project Google Cloud yang Anda buat.

   • Pilih project Google Cloud yang Anda buat:

     gcloud config set project PROJECT_ID

     Ganti PROJECT_ID dengan nama project Google Cloud Anda.

10. Aktifkan API Service Management:

    gcloud services enable servicemanagement.googleapis.com

11. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

    • Replace ROLE with each individual role.

Menguji dengan curl

1. Tentukan alias shell yang mudah untuk memanggil Google REST API:

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. Coba cantumkan layanan yang dapat diakses secara publik:

   $ gcurl https://servicemanagement.googleapis.com/v1/services
   

   Jika Anda melihat daftar layanan, berarti penyiapan berhasil.

Langkah berikutnya

Jika Anda membuat layanan terkelola dan tidak menggunakan Cloud Endpoints:

1. Ikuti Membuat dan Menghapus Layanan untuk membuat layanan terkelola. Tindakan ini akan membuat resource layanan terkelola tingkat atas.

2. Ikuti Mengelola Konfigurasi Layanan untuk mengirimkan konfigurasi layanan guna mendeskripsikan fitur yang digunakan oleh layanan.

   Catatan: Konfigurasi layanan tidak akan diterapkan setelah pengiriman. Anda harus mengikuti Langkah 3 untuk meluncurkan konfigurasi.

3. Ikuti Meluncurkan Konfigurasi Layanan untuk meluncurkan konfigurasi layanan Anda.