Method: customers.recommendationSubscriptions.mutateRecommendationSubscription

Modifica determinada assinatura com parâmetros apply correspondentes.

Lista de erros gerados: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

Solicitação HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente assinante.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "operations": [
    {
      object (RecommendationSubscriptionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Campos
operations[]

object (RecommendationSubscriptionOperation)

Obrigatório. A lista de operações de criação ou atualização.
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. O recurso mutável só vai ser retornado se tiver o campo de resposta apropriado. Por exemplo, mutateCampaignResult.campaign.

Corpo da resposta

Mensagem de resposta para [RecommendationSubscriptionService.mutateRecommendationSubscription]

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

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

object (MutateRecommendationSubscriptionResult)

Resultados, um por operação.
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 o 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.