Method: customers.adGroupAssetSets.mutate

Cria ou remove conjuntos de recursos de grupos de anúncios. Os status da operação são retornados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente cujos conjuntos de recursos do grupo de anúncios estão sendo modificados.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "operations": [
    {
      object (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Campos
operations[]

object (AdGroupAssetSetOperation)

Obrigatório. A lista de operações a serem realizadas em conjuntos de recursos de grupos de anúncios individuais.
partialFailure

boolean

Se for "true", as operações bem-sucedidas serão realizadas e as operações inválidas vão retornar erros. Se for falso, todas as operações serão realizadas em uma transação somente se forem válidas. O padrão é false
validateOnly

boolean

Se for verdadeiro, a solicitação será validada, mas não executada. Somente erros são retornados, não resultados.
responseContentType

enum (ResponseContentType)

A configuração do tipo de conteúdo da resposta. Determina se o recurso mutável ou apenas o nome do recurso precisa ser retornado após a mutação.

Corpo da resposta

Mensagem de resposta para uma mutação de conjunto de recursos de um grupo de anúncios.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "results": [
    {
      object (MutateAdGroupAssetSetResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Campos
results[]

object (MutateAdGroupAssetSetResult)

Todos os resultados da modificação.
partialFailureError

object (Status)

Erros relacionados a falhas de operação no modo de falha parcial. Retornado apenas quando partialFailure = true e todos os erros ocorrem dentro das operações. Se ocorrerem erros fora das operações (por exemplo, erros de autenticação), retornaremos um erro no nível do RPC.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adwords

Para mais informações, consulte OAuth 2.0 Overview.

AdGroupAssetSetOperation

Uma única operação (criar, remover) em um conjunto de recursos de grupo de anúncios.

Representação 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ão operation. A operação de mutação. operation pode ser apenas de um dos tipos a seguir:
create

object (AdGroupAssetSet)

Operação de criação: nenhum nome de recurso é esperado para o novo conjunto de recursos do grupo de anúncios.
remove

string

Operação de remoção: é esperado um nome de recurso para o conjunto de recursos do grupo de anúncios removido, neste formato: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

O resultado da modificação do conjunto de recursos do grupo de anúncios.

Representação JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Campos
resourceName

string

É retornado para operações bem-sucedidas.
adGroupAssetSet

object (AdGroupAssetSet)

O recurso do grupo de anúncios modificado, com apenas campos mutáveis após a mutação. O campo só será retornado quando responseContentType estiver definido como "MUTABLE_RESOURCE".