- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Pruébalo
Crea o quita conjuntos de recursos de clientes. Se muestran los estados de las operaciones.
Solicitud HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerAssetSets: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 conjuntos de recursos del cliente 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. Es la lista de operaciones que se realizarán en conjuntos individuales de recursos de clientes. |
partialFailure |
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 |
Si es verdadero, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados. |
responseContentType |
La configuración del tipo de contenido de la respuesta. Determina si se debe mostrar el recurso mutable o solo el nombre después de la mutación. |
Cuerpo de la respuesta
Mensaje de respuesta para un conjunto de recursos del cliente mutate.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "results": [ { object ( |
Campos | |
---|---|
results[] |
Todos los resultados para la función {i>mutate<i}. |
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 (p.ej., errores de autenticación), se mostrará 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.
CustomerAssetSetOperation
Una sola operación (crear, quitar) en un conjunto de recursos del cliente.
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 |
Operación de creación: No se espera ningún nombre de recurso para el nuevo conjunto de recursos de cliente. |
remove |
Operación de eliminación: Se espera un nombre de recurso para el conjunto de recursos del cliente que se quitó en el siguiente formato: |
MutateCustomerAssetSetResult
El resultado del conjunto de recursos del cliente cambiará.
Representación JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Campos | |
---|---|
resourceName |
Se muestra para las operaciones correctas. |
customerAssetSet |
El conjunto de recursos del cliente mutado con solo campos mutables después de la mutación. El campo solo se mostrará cuando responseContentType se configure como "MUTABLE_RESOURCE". |