- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- AdGroupAssetSetOperation
- MutateAdGroupAssetSetResult
- Faça um teste
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/v16/customers/{customerId}/adGroupAssetSets: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 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 ( |
Campos | |
---|---|
operations[] |
Obrigatório. A lista de operações a serem realizadas nos conjuntos de recursos individuais do grupo de anúncios. |
partialFailure |
Se verdadeiro, as operações bem-sucedidas serão executadas 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 de 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 o conjunto de recursos de um grupo de anúncios mutate.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{ "results": [ { object ( |
Campos | |
---|---|
results[] |
Todos os resultados de mutate. |
partialFailureError |
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 ocorrer algum erro fora das operações (por exemplo, erros de autenticação), retornaremos um erro de nível 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 |
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 do grupo de anúncios. |
remove |
Operação de remoção: é esperado um nome de recurso para o conjunto de recursos removido do grupo de anúncios, neste formato: |
MutateAdGroupAssetSetResult
O resultado para o conjunto de recursos do grupo de anúncios mutate.
Representação JSON |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
Campos | |
---|---|
resourceName |
Retornado para operações bem-sucedidas. |
adGroupAssetSet |
O recurso 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". |