- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- UserListCustomerTypeOperation
- MutateUserListCustomerTypeResult
- Pruébalo
Adjunta o quita tipos de clientes de listas de usuarios. Se muestran los estados de las operaciones.
Lista de errores arrojados: AuthenticationError AuthorizationError UserListCustomerTypeError HeaderError InternalError QuotaError RequestError
Solicitud HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/userListCustomerTypes: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 cuyos tipos de clientes de la lista de usuarios se modificarán. |
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 para realizar en los tipos de clientes de la lista de usuarios. |
partialFailure |
Opcional. Si el valor 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 |
Opcional. 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 un tipo de cliente de lista de usuarios mutate.
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 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), se mostrará un error de nivel de RPC. |
results[] |
Todos los resultados para 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.
UserListCustomerTypeOperation
Una sola operación de mutación en el tipo de cliente de la lista de usuarios.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión operation . Es la operación de mutación. Las direcciones (operation ) solo pueden ser una de las siguientes opciones: |
|
create |
Adjunta un tipo de cliente de lista de usuarios a una lista de usuarios. No se espera un nombre de recurso para el nuevo tipo de cliente de la lista de usuarios. |
remove |
Quita un tipo de cliente existente de lista de usuarios. Se espera un nombre de recurso para el tipo de cliente de la lista de usuarios que se quitó en el siguiente formato:
|
MutateUserListCustomerTypeResult
El resultado del tipo de cliente de la lista de usuarios mutate.
Representación JSON |
---|
{ "resourceName": string } |
Campos | |
---|---|
resourceName |
Se muestra para las operaciones correctas. |