Mutuje podaną subskrypcję z odpowiednimi 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/v15/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator subskrybowanego klienta. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "operations": [ { object ( |
Pola | |
---|---|
operations[] |
To pole jest wymagane. Lista operacji tworzenia lub aktualizacji. |
partialFailure |
Jeśli wartość to prawda, udane operacje będą wykonywane, a nieprawidłowe – będą zwracać błędy. Jeśli ma wartość false (fałsz), wszystkie operacje będą przeprowadzane w ramach jednej transakcji tylko wtedy, gdy będą prawidłowe. Wartość domyślna to false (fałsz). |
validateOnly |
Jeśli ma wartość true (prawda), żądanie jest sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki. |
responseContentType |
Ustawienie typu treści odpowiedzi. Określa, czy po mutacji ma być zwracany zmienny zasób, 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 ( |
Pola | |
---|---|
results[] |
Wyniki, po jednym na operację. |
partialFailureError |
Błędy związane z nieudanymi operacjami w trybie częściowej awarii. Zwracana tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli jakiekolwiek błędy wystąpią 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.