- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- Prova!
Crea, aggiorna o rimuove le proposte di budget dell'account. Vengono restituiti gli stati delle operazioni.
Elenco degli errori generati: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorQuotaLength ErroreStringLengthError
Richiesta HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
customerId |
Obbligatorio. L'ID del cliente. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"operation": {
object ( |
Campi | |
---|---|
operation |
Obbligatorio. L'operazione da eseguire su una singola proposta di budget a livello di account. |
validateOnly |
Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati. |
Corpo della risposta
Messaggio di risposta per le operazioni di modifica del budget a livello di account.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"result": {
object ( |
Campi | |
---|---|
result |
Il risultato della mutazione. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/adwords
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
AccountBudgetProposalOperation
Una singola operazione per proporre la creazione di un nuovo budget a livello di account o per modificare/terminare/rimuovere un budget esistente.
Rappresentazione JSON |
---|
{ "updateMask": string, // Union field |
Campi | |
---|---|
updateMask |
Maschera di campo che determina quali campi del budget vengono modificati. Sebbene i budget possano essere modificati, le proposte che propongono tali modifiche sono definitive. Di conseguenza, le operazioni di aggiornamento non sono supportate per le proposte. Le proposte che modificano i budget hanno il tipo di proposta "aggiorna". Specificare una maschera per qualsiasi altro tipo di proposta è considerato un errore. Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: |
Campo di unione operation . L'operazione di modifica. operation può essere solo uno dei seguenti: |
|
create |
Crea operazione: una nuova proposta per creare un nuovo budget, modificare un budget esistente, terminare un budget in esecuzione attiva o rimuovere un budget approvato programmato per iniziare in futuro. Non è previsto alcun nome risorsa per la nuova proposta. |
remove |
Operazione di rimozione: è previsto un nome risorsa per la proposta rimossa, nel seguente formato:
|
MutateAccountBudgetProposalResult
Il risultato della proposta di budget dell'account cambia.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Restituito per operazioni riuscite. |