Method: customers.keywordPlanAdGroups.mutate

Crea, actualiza o quita grupos de anuncios del plan de palabras clave. Se muestran los estados de las operaciones.

Lista de errores generados: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationError QuotaError RequestError ResourceCountLimitExceededError

Solicitud HTTP

POST https://googleads.googleapis.com/v20/customers/{customerId}/keywordPlanAdGroups: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 cuyos grupos de anuncios del plan de palabras clave se modificarán.

Cuerpo de la solicitud

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

Representación JSON 
{
  "operations": [
    {
      object (KeywordPlanAdGroupOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
operations[]

object (KeywordPlanAdGroupOperation)

Obligatorio. Es la lista de operaciones que se deben realizar en los grupos de anuncios individuales del plan de palabras clave.
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 devuelven errores, no resultados.

Cuerpo de la respuesta

Mensaje de respuesta para la mutación de un grupo de anuncios de un plan de palabras clave.

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

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

object (Status)

Errores relacionados con fallas de operación en el modo de falla parcial. Solo se muestra cuando partialFailure = true y todos los errores ocurren dentro de las operaciones. Si se producen errores fuera de las operaciones (por ejemplo, errores de autenticación), devolvemos un error a nivel de la RPC.
results[]

object (MutateKeywordPlanAdGroupResult)

Todos los resultados de la mutación. El orden de los resultados se determina según el orden de las palabras clave en la solicitud original.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.