- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Crea, actualiza o quita palabras clave de la campaña del plan de palabras clave. Se muestran los estados de la operación.
Lista de errores arrojados: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError.
Solicitud HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/keywordPlanCampaignKeywords:mutate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
Obligatorio. El ID del cliente cuyas palabras clave de la campaña se están modificando. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"operations": [
{
object ( |
Campos | |
---|---|
operations[] |
Obligatorio. La lista de operaciones que se deben realizar con palabras clave individuales de campañas del Plan de palabras clave. |
partialFailure |
Si es verdadero, se llevarán a cabo operaciones exitosas y las operaciones no válidas mostrarán errores. Si es falso, todas las operaciones se llevarán a cabo en una transacción solo si son válidas. El valor predeterminado es falso. |
validateOnly |
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 la modificación de una palabra clave de una campaña del Plan de palabras clave.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "partialFailureError": { object ( |
Campos | |
---|---|
partialFailureError |
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 produce algún error fuera de las operaciones (por ejemplo, errores de autenticación), se muestra un error a nivel de RPC. |
results[] |
Todos los resultados 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.