- 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/v17/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 de grupos de anúncios 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 somente se forem válidas. O padrão é false |
validateOnly |
Se for verdadeiro, a solicitação será 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 uma modificação no conjunto de recursos do grupo de anúncios.
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 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, de autenticação), vamos retornar 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 única operação (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 mutate. 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 do grupo de anúncios removido neste formato: |
MutateAdGroupAssetSetResult
O resultado da mutação do conjunto de recursos do grupo de anúncios.
Representação JSON |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
Campos | |
---|---|
resourceName |
Retornado para operações bem-sucedidas. |
adGroupAssetSet |
O recurso do grupo de anúncios modificado definido apenas com campos mutáveis depois de mutate. O campo só será retornado quando responseContentType estiver definido como "MUTABLE_RESOURCE". |