- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Faça um teste
Cria ou remove conjuntos de recursos do cliente. Os status da operação são retornados.
Solicitação HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}/customerAssetSets:mutate
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
operations[] |
Obrigatório. A lista de operações a serem realizadas nos conjuntos de recursos de clientes individuais. |
partialFailure |
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 |
Se verdadeiro, a solicitação é validada, mas não executada. Somente erros são retornados, não resultados. |
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 ( |
Campos | |
---|---|
results[] |
Todos os resultados para a função mutate. |
partialFailureError |
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 |
Campos | |
---|---|
Campo de união operation . A operação de mutação. operation pode ser apenas de um dos tipos a seguir: |
|
create |
Operação de criação: nenhum nome de recurso é esperado para o novo conjunto de recursos de cliente. |
remove |
Operação de remoção: é esperado um nome de recurso para o conjunto de recursos do cliente removido, neste formato: |
MutateCustomerAssetSetResult
O resultado para o conjunto de recursos do cliente mutate.
Representação JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Campos | |
---|---|
resourceName |
É retornado para operações bem-sucedidas. |
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". |