- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- AccountLinkOperation
- MutateAccountLinkResult
- Pruébala
Crea o quita una vinculación de cuenta. A partir de la versión 5, no se admite la creación a través de AccountLinkService.MutateAccountLink. En su lugar, usa AccountLinkService.CreateAccountLink.
Lista de errores arrojados: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError
Solicitud HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/accountLinks: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 que se modifica |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"operation": {
object ( |
Campos | |
---|---|
operation |
Obligatorio. La operación que se realizará en el vínculo. |
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 todas son válidas. El valor predeterminado es falso. |
validateOnly |
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 mutación de vinculación de cuenta.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "result": { object ( |
Campos | |
---|---|
result |
Resultado de la función {i>mutate<i}. |
partialFailureError |
Errores relacionados con fallas operativas 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 de nivel de RPC. |
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.
AccountLinkOperation
Una sola actualización sobre la vinculación de una cuenta.
Representación JSON |
---|
{ "updateMask": string, // Union field |
Campos | |
---|---|
updateMask |
FieldMask que determina qué campos de recursos se modifican en una actualización. Se trata de una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: |
Campo de unión operation . La operación que se realizará. Las direcciones (operation ) solo pueden ser una de las siguientes opciones: |
|
update |
Operación de actualización: se espera que el vínculo de la cuenta tenga un nombre de recurso válido. |
remove |
Operación de eliminación: Se espera un nombre de recurso para el vínculo de la cuenta que se quitará, en este formato:
|
MutateAccountLinkResult
Cambiará el resultado de la vinculación de la cuenta.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
Se muestra para operaciones exitosas. |