- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- AccountBudgetProposalOperation:
- MutateAccountBudgetProposalResult
- Testen!
Erstellt, aktualisiert oder entfernt Kontobudgetvorschläge. Vorgangsstatus werden zurückgegeben.
Liste der ausgegebenen Fehler: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError
HTTP-Anfrage
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
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 |
Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse. |
Antworttext
Antwortnachricht für BudgetMutate-Vorgänge 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. Zwar können Budgets geändert werden, solche Vorschläge sind jedoch endgültig. Daher werden Aktualisierungsvorgänge für Angebote nicht unterstützt. Angebote, bei denen Budgets geändert werden, haben den Angebotstyp "Aktualisieren". Wenn Sie für einen anderen Angebotstyp eine Maske angeben, wird dies als Fehler gewertet. Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: |
Union-Feld operation . Der mutate-Vorgang. Für operation ist nur einer der folgenden Werte zulässig: |
|
create |
Erstellungsvorgang: Ein neues Angebot, um ein neues Budget zu erstellen, ein vorhandenes Budget zu bearbeiten, ein aktiv laufendes Budget zu beenden oder ein genehmigtes Budget zu entfernen, dessen Startdatum in der Zukunft liegt. Für das neue Angebot wird kein Ressourcenname erwartet. |
remove |
Entfernungsvorgang: Für das entfernte Angebot wird ein Ressourcenname im folgenden Format erwartet:
|
MutateAccountBudgetProposalResult
Das Ergebnis für den Kontobudgetvorschlag ändert sich.
JSON-Darstellung |
---|
{ "resourceName": string } |
Felder | |
---|---|
resourceName |
Wird für erfolgreiche Vorgänge zurückgegeben. |