Method: customers.extensionFeedItems.mutate

Tworzy, aktualizuje lub usuwa elementy pliku danych rozszerzeń. Zwracane są stany operacji.

Lista zgłoszonych błędów: {3DenCodeError AuthorizationError CollectionSizeError CountryCodeError DatabaseError DateError DistinctError ExtensionFeedItemError FieldError FieldMaskErrorImageErrorInternalErrorLanguageCodeErrorMutateErrorNewResourceCreationErrorOperationAccessDeniedErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringLengthErrorUrlFieldError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/extensionFeedItems:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego elementy pliku danych rozszerzeń są modyfikowane.

Treść żądania

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

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

object (ExtensionFeedItemOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych elementach pliku danych rozszerzeń.
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

Ustawienie typu treści odpowiedzi. Określa, czy po mutacji ma być zwracany zmienny zasób, czy tylko jego nazwa.

Treść odpowiedzi

Komunikat z odpowiedzią dotyczącą mutacji elementu kanału rozszerzenia.

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

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

object (Status)

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.
results[]

object (MutateExtensionFeedItemResult)

Wszystkie wyniki dla mutacji.

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.