Method: customers.accountBudgetProposals.mutate

Crée, met à jour ou supprime les propositions de budget de compte. Les états des opérations sont renvoyés.

Liste des erreurs générées: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError

Requête HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/accountBudgetProposals:mutate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Champs
operation

object (AccountBudgetProposalOperation)

Obligatoire. Opération à effectuer sur une proposition de budget au niveau du compte individuel.
validateOnly

boolean

Si la valeur est "true", la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, pas les résultats.

Corps de la réponse

Message de réponse pour les opérations mutate de budget au niveau du compte.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Champs
result

object (MutateAccountBudgetProposalResult)

Résultat de la modification.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/adwords

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

AccountBudgetProposalOperation

Une seule opération pour proposer de créer un budget au niveau du compte ou de modifier/terminer/supprimer un budget existant.

Représentation JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Champs
updateMask

string (FieldMask format)

FieldMask qui détermine les champs de budget à modifier. Bien que les budgets puissent être modifiés, les propositions qui en proposent sont définitives. Par conséquent, les opérations de mise à jour ne sont pas prises en charge pour les propositions.

Les propositions qui modifient les budgets sont de type "Mettre à jour". La spécification d'un masque pour tout autre type de proposition est considérée comme une erreur.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
Champ d'union operation. L'opération mutate. operation ne peut être qu'un des éléments suivants :
create

object (AccountBudgetProposal)

Opération de création: nouvelle proposition pour créer un budget, modifier un budget existant, mettre fin à un budget en cours d'exécution ou supprimer un budget approuvé dont la date de début est postérieure à la date du jour. Aucun nom de ressource n'est attendu pour la nouvelle proposition.
remove

string

Opération de suppression: un nom de ressource pour la proposition supprimée est attendu, au format suivant:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Une demande peut être annulée si elle est en attente.

MutateAccountBudgetProposalResult

Résultat de la modification de la proposition de budget de compte.

Représentation JSON 
{
  "resourceName": string
}
Champs
resourceName

string

Est renvoyé pour les opérations réussies.