Method: customers.adGroupAssetSets.mutate

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

Solicitação HTTP

POST https://googleads.googleapis.com/v14/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 que serão realizadas nos conjuntos de recursos individuais de grupos de anúncios.
partialFailure

boolean

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

boolean

Se verdadeiro, a solicitação é 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 deve ser retornado após a mutação.

Corpo da resposta

Mensagem de resposta para a modificação de um 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 para a função mutate.
partialFailureError

object (Status)

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

AdGroupAssetSetOperation

Uma operação única (criar, remover) em um conjunto de recursos do 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 ativo do grupo de anúncios alterado definido apenas com campos mutáveis após a mutação. O campo só será retornado quando responseContentType estiver definido como "MUTABLE_RESOURCE".