Method: customers.recommendationSubscriptions.mutateRecommendationSubscription

Mutuje podaną subskrypcję z odpowiadającymi jej parametrami stosowania.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator subskrybowanego klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "operations": [
    {
      object (RecommendationSubscriptionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Pola
operations[]

object (RecommendationSubscriptionOperation)

To pole jest wymagane. listę operacji tworzenia lub aktualizacji;
partialFailure

boolean

Jeśli ma wartość true (prawda), udane operacje będą wykonywane, a nieprawidłowe – zwrócą błędy. Jeśli ma wartość false (fałsz), wszystkie operacje są wykonywane w ramach jednej transakcji i tylko wtedy, gdy są prawidłowe. Wartość domyślna to false (fałsz).
validateOnly

boolean

Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.
responseContentType

enum (ResponseContentType)

Ustawienie typu treści odpowiedzi. Określa, czy po mutacji ma zostać zwrócony zasób zmienny, czy tylko jego nazwa. Zasób zmienny zostanie zwrócony tylko wtedy, gdy ma odpowiednie pole odpowiedzi. Na przykład MutateCampaignResult.campaign.

Treść odpowiedzi

Wiadomość z odpowiedzią dla usługi [RecommendationSubscriptionService.MutateRecommendationSubscription]

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "results": [
    {
      object (MutateRecommendationSubscriptionResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Pola
results[]

object (MutateRecommendationSubscriptionResult)

Wyniki, po jednym na operację.
partialFailureError

object (Status)

Błędy związane z nieudanymi operacjami w trybie awarii częściowych. Zwracany tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli błędy wystąpią poza operacjami (np. błędy uwierzytelniania), zwrócimy błąd na poziomie RPC.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.