Method: customers.keywordPlanCampaignKeywords.mutate

Crea, actualiza o quita las palabras clave de la campaña del plan de palabras clave. Se muestran los estados de las operaciones.

Lista de errores arrojados: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError.

Solicitud HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords: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 cuyas palabras clave de la campaña se modificarán.

Cuerpo de la solicitud

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

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

object (KeywordPlanCampaignKeywordOperation)

Obligatorio. La lista de operaciones por realizar en palabras clave individuales de la campaña del plan de palabras clave.
partialFailure

boolean

Si es verdadero, se ejecutarán correctamente las operaciones y las 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

boolean

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

Cuerpo de la respuesta

Mensaje de respuesta para la palabra clave "mutate" 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 (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
Campos
partialFailureError

object (Status)

Errores relacionados con fallas de operaciones 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), mostraremos un error de nivel de RPC.
results[]

object (MutateKeywordPlanCampaignKeywordResult)

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.