Method: customers.adGroupAssetSets.mutate

Crea o quita conjuntos de recursos de los grupos de anuncios. Se muestran los estados de la operación.

Solicitud HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/adGroupAssetSets:mutate

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. Es el ID del cliente cuyos conjuntos de recursos del grupo de anuncios se están modificando.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Campos
operations[]

object (AdGroupAssetSetOperation)

Obligatorio. Es la lista de operaciones que se deben realizar en conjuntos de recursos individuales del grupo de anuncios.
partialFailure

boolean

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

boolean

Si es verdadera, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados.
responseContentType

enum (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 modificación de un conjunto de recursos de un grupo de anuncios.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "results": [
    {
      object (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Campos
results[]

object (MutateAdGroupAssetSetResult)

Todos los resultados de la función{i> mutate<i}.
partialFailureError

object (Status)

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.

AdGroupAssetSetOperation

Una sola operación (crear o quitar) en un conjunto de recursos del grupo de anuncios.

Representación JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Campos
Campo de unión operation. La operación {i>mutate<i}. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
create

object (AdGroupAssetSet)

Operación de creación: No se espera ningún nombre de recurso para el nuevo conjunto de recursos del grupo de anuncios.
remove

string

Operación de eliminación: Se espera un nombre de recurso para el conjunto de recursos del grupo de anuncios que se quitó, en este formato: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

El resultado del cambio del conjunto de recursos del grupo de anuncios.

Representación JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Campos
resourceName

string

Se muestra para operaciones exitosas.
adGroupAssetSet

object (AdGroupAssetSet)

El conjunto de recursos del grupo de anuncios mutado solo con campos mutables después de la mutación. El campo solo se mostrará cuando responseContentType esté configurado como "MUTABLE_RESOURCE".