Method: customers.accountBudgetProposals.mutate

Crea, actualiza o quita propuestas de presupuesto de la cuenta. Se muestran los estados de la operación.

Lista de errores arrojados: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Campos
operation

object (AccountBudgetProposalOperation)

Obligatorio. La operación que se realizará en una propuesta de presupuesto individual a nivel de la cuenta.
validateOnly

boolean

Si es verdadera, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados.

Cuerpo de la respuesta

Mensaje de respuesta para operaciones de modificación de presupuesto a nivel de la cuenta.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Campos
result

object (MutateAccountBudgetProposalResult)

El resultado de la función {i>mutate<i}.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

AccountBudgetProposalOperation

Una sola operación para proponer la creación de un nuevo presupuesto de la cuenta, o bien modificar, finalizar o quitar uno existente.

Representación 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.
}
Campos
updateMask

string (FieldMask format)

FieldMask que determina qué campos de presupuesto se modifican. Si bien los presupuestos pueden modificarse, las propuestas que proponen tales modificaciones son definitivas. Por lo tanto, no se admiten las operaciones de actualización para las propuestas.

Las propuestas que modifican presupuestos tienen el tipo de propuesta "Actualizar". Se considera un error especificar una máscara para cualquier otro tipo de propuesta.

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".
Campo de unión operation. La operación {i>mutate<i}. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
create

object (AccountBudgetProposal)

Crear operación: Una propuesta nueva para crear un presupuesto nuevo, editar uno existente, finalizar un presupuesto que se está ejecutando de forma activa o quitar un presupuesto aprobado que está programado para comenzar en el futuro. No se espera ningún nombre de recurso para la nueva propuesta.
remove

string

Operación de eliminación: Se espera un nombre de recurso para la propuesta que se quitó, en este formato:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Se puede cancelar una solicitud si está pendiente.

MutateAccountBudgetProposalResult

Cambiar el resultado de la propuesta de presupuesto de la cuenta

Representación JSON 
{
  "resourceName": string
}
Campos
resourceName

string

Se muestra para operaciones exitosas.