In diesem Thema erfahren Sie, wie Sie einige einfache Anfragen an die Cloud Billing API senden.
Eine vollständige Liste der Methoden finden Sie in der Referenzdokumentation zu REST oder RPC.
Vorbereitung
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Billing API aktivieren.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud 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
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Legen Sie die Umgebungsvariable
GOOGLE_APPLICATION_CREDENTIALS
auf den Pfad der JSON-Datei fest, die Ihre Anmeldedaten enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Cloud Billing API aktivieren.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud 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
. - Click Create and continue.
-
Grant the Project > Owner role to the service account.
To grant the role, find the Select a role list, then select Project > Owner.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
-
Legen Sie die Umgebungsvariable
GOOGLE_APPLICATION_CREDENTIALS
auf den Pfad der JSON-Datei fest, die Ihre Anmeldedaten enthält. Diese Variable gilt nur für Ihre aktuelle Shell-Sitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.
Liste der Cloud-Rechnungskonten abrufen
Die API-Methode zum Auflisten aller Cloud-Rechnungskonten (REST, RPC) ist die einfachste Methode in der API, da sie keine erforderlichen Parameter hat. Daher ist dies ein guter Ausgangspunkt. Die Methode gibt einfach eine Liste aller Rechnungskonten zurück, zu deren Anzeige Sie berechtigt sind.
Protokoll
GET https://cloudbilling.googleapis.com/v1/billingAccounts
Java
ListBillingAccountsResponse result = service.billingAccounts().list().execute();
Bestimmtes Cloud-Rechnungskonto abrufen
Zum Abrufen eines bestimmten Rechnungskontos (REST, RPC) müssen Sie die Rechnungskonto-ID kennen. In diesem Beispiel wird die Beispiel-ID 012345-567890-ABCDEF
verwendet.
Protokoll
GET https://cloudbilling.googleapis.com/v1/billingAccounts/012345-567890-ABCDEF
Java
BillingAccount result = service.billingAccounts() .get("billingAccounts/00C5EA-61187E-D842F2").execute();
Cloud Billing in einem Google Cloud-Projekt aktivieren
Zum Aktivieren von Cloud Billing in einem Google Cloud-Projekt müssen Sie die Cloud Billing API aufrufen, um das Google Cloud-Projekt mit einem vorhandenen Cloud-Rechnungskonto zu verknüpfen (REST, RPC).
Der folgende Beispielcode verknüpft das Google Cloud-Projekt tokyo-rain-123
mit dem Cloud-Rechnungskonto 012345-567890-ABCDEF
. Übrigens kann dieselbe API-Methode zum Deaktivieren von Cloud Billing in einem Google Cloud-Projekt verwendet werden. Dazu lassen Sie billingAccountName
leer.
Protokoll
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();
Bereinigen
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.