Achtung:Sie lesen die Dokumentation für die REST-Schnittstelle der API. Die meisten unserer offiziellen Clientbibliotheken verwenden gRPC. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

CampaignBudget

JSON-Darstellung
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Ein Kampagnenbudget

JSON-Darstellung

JSON-Darstellung
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

Felder
`resourceName`	`string` Nicht veränderbar. Der Ressourcenname des Kampagnenbudgets. Ressourcennamen von Kampagnenbudgets haben das folgende Format: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Nur Ausgabe Der Status des Kampagnenbudgets. Dieses Feld ist schreibgeschützt.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Die Bereitstellungsmethode, mit der festgelegt wird, mit welcher Rate das Kampagnenbudget ausgegeben wird. Der Standardwert ist STANDARD, wenn bei einem Erstellungsvorgang nichts angegeben ist.
`period`	`enum (BudgetPeriod)` Nicht veränderbar. Zeitraum, in dem das Budget ausgegeben werden kann. Der Standardwert ist DAILY, wenn nicht angegeben.
`type`	`enum (BudgetType)` Nicht veränderbar. Der Typ des Kampagnenbudgets.
`alignedBiddingStrategyId`	`string (int64 format)` ID der Portfolio-Gebotsstrategie, auf die dieses gemeinsame Kampagnenbudget ausgerichtet ist. Wenn eine Gebotsstrategie und ein Kampagnenbudget aufeinander abgestimmt sind, werden sie derselben Gruppe von Kampagnen zugeordnet. Nachdem ein Kampagnenbudget auf eine Gebotsstrategie abgestimmt wurde, muss für Kampagnen, die dem Kampagnenbudget hinzugefügt werden, die angepasste Gebotsstrategie verwendet werden.
`id`	`string (int64 format)` Nur Ausgabe Die ID des Kampagnenbudgets. Ein Kampagnenbudget wird mit dem CampaignBudgetService-Erstellungsvorgang erstellt und einer Budget-ID zugewiesen. Eine Budget-ID kann von verschiedenen Kampagnen gemeinsam genutzt werden. Das System verteilt das Kampagnenbudget dann auf verschiedene Kampagnen, um die optimalen Ergebnisse zu erzielen.
`name`	`string` Der Name des Kampagnenbudgets. Beim Erstellen eines Kampagnenbudgets über CampaignBudgetService muss jedes explizit freigegebene Kampagnenbudget einen Namen haben, der nicht null und nicht leer ist. Kampagnenbudgets, die nicht explizit freigegeben werden, werden aus dem Namen der angehängten Kampagne abgeleitet. Die Länge des Strings muss zwischen 1 und 255 (einschließlich) in UTF-8-Byte (ausgeschnitten) liegen.
`amountMicros`	`string (int64 format)` Der Betrag des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht. Die monatlichen Ausgaben sind auf das 30,4-Fache dieses Betrags beschränkt.
`totalAmountMicros`	`string (int64 format)` Lebensdauer des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht.
`explicitlyShared`	`boolean` Gibt an, ob das Budget explizit freigegeben wird. Standardwert ist "true", wenn in einem Erstellungsvorgang nichts angegeben ist. Wenn dies der Fall ist, wurde das Budget zum Zweck der Freigabe für eine oder mehrere Kampagnen erstellt. Wenn "false", wurde das Budget mit der Absicht erstellt, nur mit einer einzelnen Kampagne verwendet zu werden. Name und Status des Budgets werden mit dem Namen und Status der Kampagne synchronisiert. Der Versuch, dieses Budget mit einer zweiten Kampagne zu teilen, führt zu einem Fehler. Ein nicht freigegebenes Budget kann aber explizit freigegeben werden. Bei demselben Vorgang muss dem Budget auch ein Name zugewiesen werden. Ein gemeinsames Kampagnenbudget kann nie nicht freigegeben werden.
`referenceCount`	`string (int64 format)` Nur Ausgabe Die Anzahl der Kampagnen, die das Budget aktiv nutzen. Dieses Feld ist schreibgeschützt.
`hasRecommendedBudget`	`boolean` Nur Ausgabe Gibt an, ob für dieses Kampagnenbudget ein empfohlenes Budget vorhanden ist. Dieses Feld ist schreibgeschützt.
`recommendedBudgetAmountMicros`	`string (int64 format)` Nur Ausgabe Der empfohlene Budgetbetrag. Wenn keine Empfehlung verfügbar ist, wird dieser Budgetbetrag festgelegt. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht. Dieses Feld ist schreibgeschützt.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Nur Ausgabe Die geschätzte Änderung der wöchentlichen Klicks bei Anwendung des empfohlenen Budgets. Dieses Feld ist schreibgeschützt.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Nur Ausgabe Die geschätzte Änderung der wöchentlichen Kosten in Mikroeinheiten, wenn das empfohlene Budget angewendet wird. Eine Million entspricht einer Währungseinheit. Dieses Feld ist schreibgeschützt.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Nur Ausgabe Die geschätzte Änderung der wöchentlichen Interaktionen, wenn das empfohlene Budget angewendet wird. Dieses Feld ist schreibgeschützt.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Nur Ausgabe Die geschätzte Änderung der wöchentlichen Aufrufe, wenn das empfohlene Budget angewendet wird. Dieses Feld ist schreibgeschützt.

BudgetStatus

Mögliche Status eines Budgets.

Enums
`UNSPECIFIED`	Nicht angegeben.
`UNKNOWN`	Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
`ENABLED`	Budget ist aktiviert.
`REMOVED`	Das Budget wird entfernt.

BudgetDeliveryMethod

Mögliche Schaltungsmethoden eines Budgets.

Enums
`UNSPECIFIED`	Nicht angegeben.
`UNKNOWN`	Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
`STANDARD`	Der Budgetserver drosselt die Auslieferung gleichmäßig über den gesamten Zeitraum hinweg.
`ACCELERATED`	Der Budget-Server drosselt die Anzeigenschaltung nicht und die Anzeigen werden so schnell wie möglich geschaltet.

BudgetPeriod

Möglicher Zeitraum eines Budgets.

Enums
`UNSPECIFIED`	Nicht angegeben.
`UNKNOWN`	Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
`DAILY`	Tagesbudget:
`CUSTOM_PERIOD`	Benutzerdefiniertes Budget (in Version 5 wieder hinzugefügt) Benutzerdefiniertes Budget kann zusammen mit „total_amount“ verwendet werden, um das Gesamtbudget festzulegen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/6385083.

BudgetType

Mögliche Budgettypen.

Enums
`UNSPECIFIED`	Nicht angegeben.
`UNKNOWN`	Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
`STANDARD`	Budgettyp für die standardmäßige Google Ads-Nutzung. Beschränkt die täglichen Ausgaben auf das Doppelte des angegebenen Budgetbetrags. Weitere Informationen: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Budgettyp mit einem festen Cost-per-Acquisition (Conversion). Weitere Informationen: https://support.google.com/google-ads/answer/7528254 Dieser Typ wird nur in Kampagnen mit AdvertisingChannelType.DISPLAY (ohne AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA und PaymentMode.CONVERSIONS unterstützt.
`SMART_CAMPAIGN`	Budgettyp für smarte Kampagne. Weitere Informationen: https://support.google.com/google-ads/answer/7653509 Dieser Typ wird nur in Kampagnen mit AdvertisingChannelType.SMART und AdvertisingChannelSubType.SMART_CAMPAIGN unterstützt.
`LOCAL_SERVICES`	Budgettyp für die Kampagne für lokale Dienstleistungen. Weitere Informationen: https://support.google.com/localservices/answer/7434558 Dieser Typ wird nur in Kampagnen mit AdvertisingChannelType.LOCAL_SERVICES unterstützt.