Wenn Sie aufgefordert werden, das Google Cloud -Projekt zu bestätigen, das Sie für die Cloud Billing Catalog API verwenden möchten, empfehlen wir Ihnen, ein Projekt zu verwenden, das für alle Ihre Anforderungen an die FinOps- und Abrechnungsverwaltung für ein Cloud-Rechnungskonto eingerichtet ist, einschließlich der Aktivierung der Cloud Billing API.
[SERVICE_NAME] ist der Ressourcenname des Dienstes.
[SERVICE_ID] ist die Kennzeichnung des Dienstes.
[DISPLAY_NAME] ist der menschenlesbare Anzeigename des Dienstes.
Die Ergebnisse sind paginiert und auf 5.000 SKUs pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächsten 5.000 Ergebnisse abrufen können.
Legen Sie pageToken=[NEXT_PAGE_TOKEN] fest, um den nächsten Batch abzurufen.
Wenn Sie die Anzahl der Artikelnummern pro Seite ändern möchten, legen Sie pageSize=[CUSTOM_PAGE_SIZE] fest.
Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben.
Liste mit Artikelnummern für einen Dienst abrufen
Mit dem folgenden Code-Snippet werden die Artikelnummern im Katalog für den angegebenen Dienst aufgelistet:
Anfrage:
GET https://cloudbilling.googleapis.com/v1/services/SERVICE_ID/skus?key=<var>API_KEY</var>
Dabei gilt:
SERVICE_ID ist die Kennzeichnung des übergeordneten Dienstes.
[SKU_NAME] ist der Ressourcenname für die Artikelnummer im Format services/{SERVICE_ID}/skus/{SKU_ID}.
[SKU_ID] gibt die eindeutige Kennzeichnung der Artikelnummer an.
[SKU_DESCRIPTION] gibt eine menschenlesbare Beschreibung der Artikelnummer an.
[SVC_DISPLAY_NAME] gibt den Anzeigenamen des Diensts an, zu dem die Artikelnummer gehört.
[FAMILY] gibt den Typ des Artikels an, auf den sich die Artikelnummer bezieht, zum Beispiel: "Computing", "Storage", "Network" usw.
[GROUP] gibt eine Gruppenklassifikation für verwandte Artikelnummern an, zum Beispiel: "RAM", "GPU", "Prediction" usw.
[USAGE] gibt an, wie die Artikelnummer genutzt wird, zum Beispiel: "OnDemand", "Preemptible", "Commit1Mo", "Commit1Yr" usw.
[REGION] ist die Liste Dienstregionen, in denen die Artikelnummer angeboten wird, zum Beispiel: "asia-east1".
[TIME] gibt den Zeitstempel für den Zeitpunkt an, ab dem der Preis gültig war, im Format 2014-10-02T15:01:23.045123456Z.
[SUMMARY] bietet eine menschenlesbare Zusammenfassung der Preisinformationen.
[USAGE_UNIT] gibt das Kürzel der Nutzungseinheit an, in der der Preis angegeben ist. Beispiel: "GiBy" als usageUnit bedeutet, dass die Nutzung in "Gibibyte" angegeben ist.
[USAGE_UNIT_DESCRIPTION] gibt die Nutzungseinheit in menschenlesbarer Form an, zum Beispiel: "Gibibyte".
[BASE_UNIT] ist die Basiseinheit der Artikelnummer und wird in Nutzungsexporten verwendet. Beispiel: baseUnit "By" bedeutet, dass die Nutzung in "Byte" angegeben ist.
[BASE_UNIT_DESCRIPTION] ist die Basiseinheit in einer visuell lesbaren Form. Beispiel: "Byte"
[BASE_CONVERSION_FACTOR] ist der Konvertierungsfaktor, der den Preis pro usage_unit in den Preis pro base_unit konvertiert und den Betrag für start_usage in start_usage_amount in base_unit konvertiert. Beispiel: start_usage_amount *
base_unit_conversion_factor = start_usage_amount in base_unit.
[DISPLAY_QUANTITY] gibt die empfohlene Anzahl von Einheiten für die Anzeige von Preisangaben an. Bei der Anzeige von Preisangaben sollte (unitPrice * displayQuantity) per displayQuantity usageUnit angezeigt werden. Dieses Feld wirkt sich nicht auf die Preisformel aus und dient nur zu Anzeigezwecken.
Beispiel: Wenn unitPrice auf "0,0001 USD", usageUnit auf "GB" und displayQuantity auf "1.000" festgelegt sind, sollten die Preisangaben in der Form "0,10 USD pro 1.000 GB" angezeigt werden.
[START_AMOUNT] gibt die Nutzungsmenge an, ab deren Erreichen die Nutzung zum festgelegten Tarif berechnet wird. Beispiel: Ein startUsageAmount von 10 gibt an, dass die Nutzung nach den ersten 10 usage_units zum unten festgelegten Tarif berechnet wird.
[CURRENCY_CODE] gibt den aus drei Buchstaben bestehenden Währungscode entsprechend der ISO 4217-Definition an.
[UNITS] gibt die ganzen Einheiten des Betrags an. Beispiel: Wenn für "currencyCode" der Wert "USD" angegeben ist, entspricht eine Einheit 1 US-Dollar.
[NANOS] gibt die Anzahl der Nanoeinheiten (10^-9) des Betrags an. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn "units" positiv ist, müssen die Nanoeinheiten positiv oder null sein. Wenn "units" null ist, können die Nanoeinheiten positiv, null oder negativ sein. Wenn "units" negativ ist, müssen die Nanoeinheiten negativ oder null sein.
Die Kosten für die SKU betragen units + nanos. Beispiel: Kosten von 1, 75 $ werden mit units=1 und nanos=750,000,000 dargestellt.
[AGGREGATION_LEVEL] gibt die Ebene an, auf der die Nutzung zur Kostenberechnung zusammengefasst wird. Gültige Werte sind ACCOUNT, PROJECT und AGGREGATION_LEVEL_UNSPECIFIED.
[AGGREGATION_INTERVAL] gibt das Intervall an, in dem die Nutzung zur Kostenberechnung zusammengefasst wird. Gültige Werte sind DAILY, MONTHLY und AGGREGATION_INTERVAL_UNSPECIFIED.
[AGGREGATION_COUNT] gibt die Anzahl der zusammenzufassenden Intervalle an. Beispiel: Wenn aggregationLevel "DAILY" und aggregationCount "14" ist, erfolgt die Zusammenfassung über 14 Tage.
[CONVERSION_RATE] gibt den Wechselkurs für die Währungsumrechnung von USD in die Währung an, die in der Anfrage angegeben ist. Wenn keine Währung angegeben ist, wird als Standardwert 1,0 verwendet.
[SERVICE_PROVIDER] identifiziert den Dienstanbieter. Für Erstanbieterdienste in der Google Cloud Platform ist dies "Google".
[TAXONOMY_TYPE] ist der Typ der geografischen Taxonomie für eine Artikelnummer: GLOBAL, REGIONAL oder MULTI_REGIONAL.
[REGION] gibt die Liste der Regionen an, die einer Artikelnummer zugeordnet sind. Dieses Feld ist für globale Artikelnummern leer, da sie allen Google CloudRegionen zugeordnet sind.
Die Ergebnisse sind paginiert und auf 5.000 SKUs pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächsten 5.000 Ergebnisse abrufen können.
Legen Sie pageToken=[NEXT_PAGE_TOKEN] fest, um den nächsten Batch abzurufen.
Wenn Sie die Anzahl der Artikelnummern pro Seite ändern möchten, legen Sie pageSize=[CUSTOM_PAGE_SIZE] fest.
Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["\u003cp\u003eThe Cloud Billing Catalog API allows users to retrieve a list of all public services and their associated metadata.\u003c/p\u003e\n"],["\u003cp\u003eUsers can obtain a comprehensive list of public Stock Keeping Units (SKUs) within a service, including their descriptions, pricing, availability regions, and categorization data.\u003c/p\u003e\n"],["\u003cp\u003eCustom contract pricing can be accessed via the separate Pricing API, while public pricing is available through the Cloud Billing Catalog API.\u003c/p\u003e\n"],["\u003cp\u003eUsing the Cloud Billing Catalog API requires enabling the Cloud Billing API and obtaining an API key.\u003c/p\u003e\n"],["\u003cp\u003eAPI responses are paginated, returning up to 5000 SKUs per page, with a \u003ccode\u003enextPageToken\u003c/code\u003e provided for retrieving subsequent pages of results.\u003c/p\u003e\n"]]],[],null,["# Get publicly available Google Cloud pricing information\n\n\u003cbr /\u003e\n\nThis page shows you how to use the Cloud Billing Catalog API to:\n\n- Get a list of all public services including relevant metadata about each service.\n- Get a list of all public SKUs within a service including:\n - Human readable description of the SKU.\n - Public pricing of the SKU.\n - Regions where the SKU is available for purchase.\n - Categorization data about the SKU.\n\nIf you have **custom contract pricing** , you can use the\n[Pricing API](/billing/docs/how-to/get-pricing-information-api)\nto get prices that are applicable to your Cloud Billing account.\n\nBefore you begin\n----------------\n\nBefore you can use the Cloud Billing Catalog API, you'll need to enable the\nCloud Billing API and get an API key.\n\n\nEnable the Cloud Billing API.\n\n\n[Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=cloudbilling.googleapis.com)\n\nWhen you are prompted to confirm the Google Cloud project you intend to use\nfor the Cloud Billing Catalog API, we recommend you use a project that is set up\nto contain all of your FinOps and billing administration needs for a\nCloud Billing account, including where the Cloud Billing API is\nenabled.\n\n[Learn more about the benefits to using a FinOps-focused project](/billing/docs/how-to/create-billing-account#set-up-billing-project)\nfor your billing administration use cases.\n\n#### Get an API key\n\nCalling the Cloud Billing Catalog API requires an API Key. You can find\ndetails about API Keys in\n[Using API Keys](/docs/authentication/api-keys).\n\nListing public services from the catalog\n----------------------------------------\n\nIn this step you will get a list of all public services including relevant\nmetadata about each service.\n\nThe following code snippet lists all public services in the catalog.\n\nRequest:\n\n`GET https://cloudbilling.googleapis.com/v1/services?key=\u003cvar\u003eAPI_KEY\u003c/var\u003e`\n\nResponse: \n\n {\n \"services\": [\n {\n \"name\": \"[SERVICE_NAME]\",\n \"serviceId\": \"[SERVICE_ID]\",\n \"displayName\": \"[DISPLAY_NAME]\",\n },\n [...]\n ],\n \"nextPageToken\": \"[NEXT_PAGE_TOKEN]\"\n }\n\nWhere:\n\n- `[SERVICE_NAME]` is the resource name for the service.\n- `[SERVICE_ID]` is the identifier for the service.\n- `[DISPLAY_NAME]` is the human readable display name for the service.\n\nResults are paginated, and are limited to **5000** SKUs per page. The response\nincludes a `nextPageToken` that you can use to get the next 5000 results.\nTo fetch the next batch, set `pageToken=[`\u003cvar translate=\"no\"\u003eNEXT_PAGE_TOKEN\u003c/var\u003e`]`.\nTo reduce the number of SKUs per page, set\n`pageSize=[`\u003cvar translate=\"no\"\u003eCUSTOM_PAGE_SIZE\u003c/var\u003e`]`.\nWhen all items have been listed, no token is returned.\n\nGetting the list of SKUs for a service\n--------------------------------------\n\nThe following code snippet lists the SKUs in the catalog for the\nspecified service:\n\nRequest:\n\n`GET https://cloudbilling.googleapis.com/v1/services/SERVICE_ID/skus?key=\u003cvar\u003eAPI_KEY\u003c/var\u003e`\n\nWhere:\n\n- `SERVICE_ID` is the identifier of the parent service.\n\nResponse: \n\n {\n \"skus\": [\n {\n \"name\": \"[SKU_NAME]\",\n \"skuId\": \"[SKU_ID]\",\n \"description\": \"[SKU_DESCRIPTION]\",\n \"category\": {\n \"serviceDisplayName\": \"[SVC_DISPLAY_NAME]\",\n \"resourceFamily\": \"[FAMILY]\",\n \"resourceGroup\": \"[GROUP]\",\n \"usageType\": \"[USAGE]\",\n },\n \"serviceRegions\": [\n \"[REGION]\"\n ],\n \"pricingInfo\": [\n {\n \"effectiveTime\": \"[TIME]\",\n \"summary\": \"[SUMMARY]\",\n \"pricingExpression\": {\n \"usageUnit\": \"[USAGE_UNIT]\",\n \"usageUnitDescription\": \"[USAGE_UNIT_DESCRIPTION]\",\n \"baseUnit\": \"[BASE_UNIT]\",\n \"baseUnitDescription\": \"[BASE_UNIT_DESCRIPTION]\",\n \"baseUnitConversionFactor\": [BASE_CONVERSION_FACTOR],\n \"displayQuantity\": [DISPLAY_QUANTITY],\n \"tieredRates\": [\n {\n \"startUsageAmount\": [START_AMOUNT],\n \"unitPrice\": {\n \"currencyCode\": \"[CURRENCY_CODE]\",\n \"units\": [UNITS],\n \"nanos\": [NANOS],\n },\n }\n ],\n },\n \"aggregationInfo\": {\n \"aggregationLevel\": enum(\"[AGGREGATION_LEVEL]\"),\n \"aggregationInterval\": enum(\"[AGGREGATION_INTERVAL]\"),\n \"aggregationCount\": [AGGREGATION_COUNT],\n },\n \"currencyConversionRate\": [CONVERSION_RATE],\n }\n ],\n \"serviceProviderName\": \"[SERVICE_PROVIDER]\",\n \"geoTaxonomy\": {\n \"type\": \"[TAXONOMY_TYPE]\",\n \"regions\": [\n \"[REGION]\"\n ]\n }\n }\n ],\n \"nextPageToken\": \"[NEXT_PAGE_TOKEN]\"\n }\n\nWhere:\n\n- `[SKU_NAME]` is the resource name for the SKU in the form `services/{SERVICE_ID}/skus/{SKU_ID}`.\n- `[SKU_ID]` is the unique identifier for the SKU.\n- `[SKU_DESCRIPTION]` is a human readable description of the SKU.\n- `[SVC_DISPLAY_NAME]` is the display name of the service to which the SKU belongs.\n- `[FAMILY]` is the type of product the SKU refers to. For example, \"Compute\", \"Storage\", \"Network\", etc.\n- `[GROUP]` is a group classification for related SKUs. For example, \"RAM, \"GPU\", \"Prediction\", etc.\n- `[USAGE]` represents how the SKU is consumed. For example, \"OnDemand, \"Preemptible, \"Commit1Mo\", \"Commit1Yr\", etc.\n- `[REGION]` is the list of [service regions](/about/locations) in which the SKU is offered. For example, \"asia-east1\".\n- `[TIME]` is a timestamp representing the time from which this pricing was effective in the form `2014-10-02T15:01:23.045123456Z`.\n- `[SUMMARY]` is a human readable summary of the pricing information,\n- `[USAGE_UNIT]` is the shorthand for the unit of usage in which the pricing is specified. For example, `usageUnit` of \"GiBy\" means that usage is specified in \"Gibibytes\".\n- `[USAGE_UNIT_DESCRIPTION]` is the unit of usage in human readable form, for example, \"Gibibyte\".\n- `[BASE_UNIT]` is the SKU's base unit, and is the unit used in usage exports. For example, `baseUnit` of \"By\" means the usage is specified in \"Bytes\".\n- `[BASE_UNIT_DESCRIPTION]` is the base unit in human readable form. For example, \"byte\".\n- `[BASE_CONVERSION_FACTOR]` is the conversion factor for converting price per usage_unit to price per base_unit, and converting start_usage amount to start_usage_amount in base_unit. For example, *start_usage_amount \\*\n base_unit_conversion_factor = start_usage_amount in base_unit.*\n- `[DISPLAY_QUANTITY]` is the recommended quantity of units for displaying pricing info. When displaying pricing info, it is recommended to display: `(unitPrice * displayQuantity) per displayQuantity usageUnit`. This field does not affect the pricing formula and is for display purposes only. For example, if the `unitPrice` is \"0.0001 USD\", the `usageUnit` is \"GB\" and the `displayQuantity` is \"1000\", then the recommended way to display the pricing info is \"0.10 USD per 1000 GB\".\n- `[START_AMOUNT]` Usage is priced at the rate only after this amount is consumed. For example, a `startUsageAmount` of 10 indicates that the usage will be priced at the price defined below after the first 10 `usage_units`.\n- `[CURRENCY_CODE]` is the three-letter currency code defined as in ISO 4217.\n- `[UNITS]` is the whole units of the amount. For example if currencyCode is \"USD\", then 1 unit is one US dollar.\n- `[NANOS]` is the number of nano (10\\^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If units is positive, nanos must be positive or zero. If units is zero, nanos can be positive, zero, or negative. If units is negative, nanos must be negative or zero.\n\nThe cost of the SKU is `units + nanos`. For example, a cost of $1.75 is\nrepresented as `units=1` and `nanos=750,000,000`.\n\n- `[AGGREGATION_LEVEL]` is the level at which usage is aggregated to compute cost. Valid values are ACCOUNT, PROJECT, and AGGREGATION_LEVEL_UNSPECIFIED.\n- `[AGGREGATION_INTERVAL]` is the interval at which usage is aggregated to compute cost. Valid values are DAILY, MONTHLY, and AGGREGATION_INTERVAL_UNSPECIFIED.\n- `[AGGREGATION_COUNT]` is the number of intervals to aggregate over. For example, if `aggregationLevel` is \"DAILY\" and `aggregationCount` is 14, aggregation will be over 14 days.\n- `[CONVERSION_RATE]` is the conversion rate for currency conversion, from USD to the currency specified in the request. If the currency is not specified this defaults to 1.0.\n- `[SERVICE_PROVIDER]` identifies the service provider. This is 'Google' for first party services in Google Cloud Platform.\n- `[TAXONOMY_TYPE]` is the type of geographic taxonomy for a SKU: `GLOBAL`, `REGIONAL`, or `MULTI_REGIONAL`.\n- `[REGION]` is The list of regions associated with a SKU. This field is empty for Global SKUs since they are associated with all Google Cloudregions.\n\nResults are paginated, and are limited to **5000** SKUs per page. The response\nincludes a `nextPageToken` that you can use to get the next 5000 results.\nTo fetch the next batch, set `pageToken=[`\u003cvar translate=\"no\"\u003eNEXT_PAGE_TOKEN\u003c/var\u003e`]`.\nTo reduce the number of SKUs per page, set\n`pageSize=[`\u003cvar translate=\"no\"\u003eCUSTOM_PAGE_SIZE\u003c/var\u003e`]`.\nWhen all items have been listed, no token is returned.\n\nRelated information\n-------------------\n\nPricing and SKU information is also available in the\n[pricing table report](/billing/docs/how-to/pricing-table)\nor the\n[Cloud Billing pricing export to BigQuery](/billing/docs/how-to/export-data-bigquery)."]]
