Method: customers.adGroupBidModifiers.mutate

Crea, actualiza o quita modificadores de ofertas de grupos de anuncios. Se muestran los estados de las operaciones.

Lista de errores generados: AdGroupBidModifierError AuthenticationError AuthorizationError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError OperatorError QuotaError RangeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. ID del cliente cuyos modificadores de oferta del grupo de anuncios se modifican.

Cuerpo de la solicitud

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

Representación JSON 
{
  "operations": [
    {
      object (AdGroupBidModifierOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Campos
operations[]

object (AdGroupBidModifierOperation)

Obligatorio. Es la lista de operaciones que se deben realizar en los modificadores de ofertas de grupos de anuncios individuales.
partialFailure

boolean

Si es verdadero, se llevarán a cabo las operaciones correctas y las operaciones no válidas mostrarán errores. Si es falso, todas las operaciones se llevarán a cabo en una sola transacción solo si todas son válidas. El valor predeterminado es falso.
validateOnly

boolean

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

enum (ResponseContentType)

Es la configuración del tipo de contenido de la respuesta. Determina si se debe mostrar el recurso mutable o solo el nombre del recurso después de la mutación.

Cuerpo de la respuesta

Es el mensaje de respuesta para la mutación de modificadores de ofertas del grupo de anuncios.

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

Representación JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateAdGroupBidModifierResult)
    }
  ]
}
Campos
partialFailureError

object (Status)

Errores relacionados con fallas de operación en el modo de falla parcial. Se muestra solo cuando partialFailure = true y todos los errores ocurren dentro de las operaciones. Si se produce algún error fuera de las operaciones (por ejemplo, errores de autenticación), se mostrará un error de nivel de RPC.
results[]

object (MutateAdGroupBidModifierResult)

Todos los resultados para la función {i>mutate<i}.

Alcances 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.