- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- Testen!
Erstellt, aktualisiert oder entfernt Kontobudgetvorschläge. Vorgangsstatus werden zurückgegeben.
Liste der ausgelösten Fehler: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError
HTTP-Anfrage
POST https://googleads.googleapis.com/v16/customers/{customerId}/accountBudgetProposals:mutate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
customerId |
Erforderlich. Die ID des Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"operation": {
object ( |
Felder | |
---|---|
operation |
Erforderlich. Vorgang, der für einen einzelnen Budgetvorschlag auf Kontoebene ausgeführt werden soll |
validateOnly |
Bei „true“ wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse. |
Antworttext
Antwortnachricht für Budgetänderungen auf Kontoebene
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"result": {
object ( |
Felder | |
---|---|
result |
Das Ergebnis der Änderung. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
AccountBudgetProposalOperation
Ein einzelner Vorgang, um die Erstellung eines neuen Budgets auf Kontoebene vorzuschlagen oder ein vorhandenes Budget zu bearbeiten, zu beenden oder zu entfernen
JSON-Darstellung |
---|
{ "updateMask": string, // Union field |
Felder | |
---|---|
updateMask |
FieldMask, die bestimmt, welche Budgetfelder geändert werden. Auch wenn Budgets geändert werden können, sind Vorschläge, in denen solche Änderungen vorgeschlagen werden, endgültig. Daher werden Aktualisierungsvorgänge für Angebote nicht unterstützt. Angebote, bei denen Budgets geändert werden, haben den Angebotstyp "Aktualisieren". Das Angeben einer Maske für einen anderen Angebotstyp wird als Fehler betrachtet. Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: |
Union-Feld operation . Der Vorgang "mutate" Für operation ist nur einer der folgenden Werte zulässig: |
|
create |
Erstellungsvorgang: Ein neues Angebot zum Erstellen eines neuen Budgets, zum Bearbeiten eines vorhandenen Budgets, zum Beenden eines aktiv laufenden Budgets oder zum Entfernen eines genehmigten Budgets mit einem Start in der Zukunft. Für das neue Angebot wird kein Ressourcenname erwartet. |
remove |
Vorgang zum Entfernen: Für das entfernte Angebot wird ein Ressourcenname in folgendem Format erwartet:
|
MutateAccountBudgetProposalResult
Das Ergebnis des Kontobudgetvorschlags ändert sich.
JSON-Darstellung |
---|
{ "resourceName": string } |
Felder | |
---|---|
resourceName |
Wird für erfolgreiche Vorgänge zurückgegeben. |