- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Pruébala
Crea o quita conjuntos de recursos de clientes. Se muestran los estados de la operación.
Solicitud HTTP
POST https://googleads.googleapis.com/v14/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 están modificando. |
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 individuales de recursos 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 son válidas. El valor predeterminado es falso. |
validateOnly |
Si es verdadera, 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 de la función{i> mutate<i}. |
partialFailureError |
Errores relacionados con fallas de operación 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 a 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 {i>mutate<i}. 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
El resultado de la mutación 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 mutado solo con campos mutables después de la mutación. El campo solo se mostrará cuando responseContentType esté configurado como "MUTABLE_RESOURCE". |