Method: customers.assetSetAssets.mutate

Tworzy, aktualizuje lub usuwa komponenty zestawu zasobów. Stany operacji są zwracane.

Żądanie HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/assetSetAssets:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego zasoby w zestawie zasobów są modyfikowane.

Treść żądania

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

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

object (AssetSetAssetOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych zasobach w zestawie zasobów.

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.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą przekształcenia zasobu w zestawie zasobów.

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

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

object (MutateAssetSetAssetResult)

Wszystkie wyniki dla mutacji.

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.