Mengirim Permintaan

Topik ini menunjukkan cara mengirim beberapa permintaan sederhana ke Cloud Billing API.

Untuk mengetahui daftar lengkap metode, lihat dokumentasi referensi REST atau RPC.

Sebelum memulai

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Cloud Billing API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  4. Create a service account:

    1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.
    2. In the Cloud de Confiance console, go to the Create service account page.

      Go to Create service account
    3. Select your project.
    4. In the Service account name field, enter a name. The Cloud de Confiance console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    5. Click Create and continue.
    6. Grant the Project > Owner role to the service account.

      To grant the role, find the Select a role list, then select Project > Owner.

    7. Click Continue.
    8. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

  5. Create a service account key:

    1. In the Cloud de Confiance console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.
  6. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

Mendapatkan daftar Akun Penagihan Cloud

Metode API untuk mencantumkan semua Akun Penagihan Cloud (REST, RPC) adalah metode termudah di API karena tidak memiliki parameter yang diperlukan. Jadi, ini merupakan tempat yang tepat untuk memulai. Metode ini hanya menampilkan semua akun penagihan yang dapat Anda lihat.

Protocol

GET https://cloudbilling.googleapis.com/v1/billingAccounts

Java

    ListBillingAccountsResponse result = service.billingAccounts().list().execute();

Mengambil Akun Penagihan Cloud tertentu

Untuk mengambil akun penagihan tertentu (REST, RPC), Anda harus mengetahui ID akun penagihan. Contoh ini menggunakan ID contoh 012345-567890-ABCDEF.

Protocol

GET https://cloudbilling.googleapis.com/v1/billingAccounts/012345-567890-ABCDEF

Java

    BillingAccount result = service.billingAccounts()
        .get("billingAccounts/00C5EA-61187E-D842F2").execute();

Mengaktifkan Penagihan Cloud di Cloud de Confiance project

Untuk mengaktifkan Penagihan Cloud di Cloud de Confiance project, Anda harus memanggil Cloud Billing API untuk mengaitkan Cloud de Confiance project dengan Akun Penagihan Cloud yang ada (REST, RPC). Kode contoh berikut mengaitkan Cloud de Confiance project tokyo-rain-123 dengan Akun Penagihan Cloud 012345-567890-ABCDEF. Selain itu, metode API yang sama juga dapat digunakan untuk menonaktifkan Penagihan Cloud di project Cloud de Confiance dengan cara menetapkan billingAccountName ke kosong.

Protocol

PUT https://cloudbilling.googleapis.com/v1/projects/tokyo-rain-123/billingInfo

{
  "billingAccountName": "billingAccounts/012345-567890-ABCDEF"
}

Java

    service.projects().updateBillingInfo(
            "projects/tokyo-rain-123",
            new ProjectBillingInfo().setBillingAccountName("billingAccounts/012345-567890-ABCDEF"))
        .execute();

Pembersihan

  1. Di Cloud de Confiance konsol, buka halaman Manage resources.

    Buka Kelola resource

  2. Pada daftar project, pilih project yang Anda ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.