Mutuje daną subskrypcję za pomocą odpowiednich parametrów zastosowania.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError.
Żądanie HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
Wymagane. Identyfikator subskrybującego klienta. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "operations": [ { object ( |
Pola | |
---|---|
operations[] |
Wymagane. Lista operacji tworzenia lub aktualizacji. |
partialFailure |
Jeśli ma wartość true (prawda), wykonywane są udane operacje, a nieprawidłowe – zwracają błędy. W przypadku wartości false (fałsz) wszystkie operacje będą wykonywane w ramach jednej transakcji tylko wtedy, gdy są prawidłowe. Wartość domyślna to false (fałsz). |
validateOnly |
Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki. |
responseContentType |
Ustawienie typu treści odpowiedzi. Określa, czy po mutacji powinien zostać zwrócony zasób zmienny, czy tylko jego nazwa. Zasób zmienny jest zwracany tylko wtedy, gdy zasób ma odpowiednie pole odpowiedzi. Na przykład MutateCampaignResult.campaign. |
Treść odpowiedzi
Odpowiedź na temat subskrypcji [RecommendationSubscriptionService.MutateRecommendationSubscription]
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "results": [ { object ( |
Pola | |
---|---|
results[] |
Wyniki, po jednym na operację. |
partialFailureError |
Błędy, które odnoszą się do nieudanych operacji w trybie częściowej awarii. Zwracany tylko wtedy, gdy częściowyFailure ma wartość true (prawda) i wszystkie błędy występują w ramach operacji. Jeśli wystąpią jakieś błędy poza operacjami (na przykład 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 artykule Omówienie protokołu OAuth 2.0.