Method: customers.customerAssetSets.mutate

Cria ou remove conjuntos de recursos do cliente. Os status da operação são retornados.

Solicitação HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerAssetSets: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 de clientes 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 (CustomerAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Campos
operations[]

object (CustomerAssetSetOperation)

Obrigatório. A lista de operações a serem realizadas nos conjuntos de recursos de clientes individuais.
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 do cliente.

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

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

object (MutateCustomerAssetSetResult)

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.

CustomerAssetSetOperation

Uma operação única de criação ou remoção em um conjunto de recursos do cliente.

Representação JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerAssetSet)
  },
  "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 (CustomerAssetSet)

Operação de criação: nenhum nome de recurso é esperado para o novo conjunto de recursos de cliente.
remove

string

Operação de remoção: é esperado um nome de recurso para o conjunto de recursos do cliente removido, neste formato: customers/{customerId}/customerAssetSets/{asset_set_id}

MutateCustomerAssetSetResult

O resultado para o conjunto de recursos do cliente mutate.

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

string

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

object (CustomerAssetSet)

O ativo do cliente modificado definido apenas com campos mutáveis após a mutação. O campo só será retornado quando responseContentType estiver definido como "MUTABLE_RESOURCE".