Aktualizuje reklamy. Stany operacji są zwracane. Aktualizowanie reklam nie jest obsługiwane w przypadku reklam tekstowych, rozszerzonych dynamicznych reklam w wyszukiwarce, reklam w Gmailu i reklam graficznych.
<br class="Error-Error-Error-40">300%2032-039-klasy-lub-żad-błędów.AdCustomizerErrorAdErrorAdSharingErrorAdxErrorAssetErrorAssetLinkErrorAuthenticationErrorAuthorizationErrorCollectionSizeErrorDatabaseErrorDateErrorDistinctErrorFeedAttributeReferenceErrorFieldErrorFieldMaskErrorFunctionErrorFunctionParsingErrorHeaderErrorIdErrorImageErrorInternalErrorListOperationErrorMediaBundleErrorMediaFileErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperatorErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldError
Żądanie HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/ads:mutate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta, którego reklamy są modyfikowane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "operations": [ { object ( |
Pola | |
---|---|
operations[] |
To pole jest wymagane. Lista operacji do wykonania na poszczególnych reklamach. |
partialFailure |
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). |
responseContentType |
Ustawienie typu treści odpowiedzi. Określa, czy po mutacji ma zostać zwrócony zasób zmienny, czy tylko jego nazwa. |
validateOnly |
Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki. |
Treść odpowiedzi
Wiadomość z odpowiedzią na zmianę reklamy.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "partialFailureError": { object ( |
Pola | |
---|---|
partialFailureError |
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. |
results[] |
Wszystkie wyniki dla mutacji. |
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.