Method: customers.accountBudgetProposals.mutate

Crée, met à jour ou supprime des 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/v14/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 de mutation du 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 opération mutate.

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

Opération unique permettant de proposer la création d'un budget au niveau du compte ou la modification/l'arrêt/la suppression d'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 modifiés. Même si les budgets peuvent être modifiés, les propositions proposant de telles modifications sont définitives. Par conséquent, les opérations de mise à jour ne sont pas acceptées pour les propositions.

Les propositions qui modifient les budgets sont associées au type de proposition "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 complets de champs 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 située dans le futur. Aucun nom de ressource n'est attendu pour la nouvelle proposition.
remove

string

Opération de suppression: le nom de ressource attendu pour la proposition supprimée doit être 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 mutation de la proposition de budget de compte.

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

string

Retourné pour les opérations réussies.