- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Pruébala
Crea o quita conjuntos de recursos de clientes. Se muestran los estados de las operaciones.
Solicitud HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerAssetSets:mutate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
Obligatorio. Es el ID del cliente cuyos conjuntos de recursos del cliente se modifican. |
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 deben realizar en conjuntos de recursos individuales de clientes. |
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. |
responseContentType |
La configuración del tipo de contenido de la respuesta. Determina si el recurso mutable o solo el nombre del recurso se debe mostrar después de la mutación. |
Cuerpo de la respuesta
Mensaje de respuesta para la mutación de un conjunto de recursos de un cliente.
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 mutación. |
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 (p.ej., 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.
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 . 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 conjunto de recursos del cliente nuevo. |
remove |
Operación de eliminación: Se espera un nombre de recurso para el conjunto de recursos del cliente que se quitó, en este formato: |
MutateCustomerAssetSetResult
Cambiar el resultado del conjunto de recursos del cliente.
Representación JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Campos | |
---|---|
resourceName |
Se muestra para operaciones exitosas. |
customerAssetSet |
El conjunto de recursos del cliente modificado solo con campos mutables después de la mutación El campo solo se mostrará cuando responseContentType se establezca en "MUTABLE_RESOURCE". |