Method: customers.customerAssetSets.mutate

Tworzy lub usuwa zestawy komponentów klienta. Zwracane są stany operacji.

Żądanie HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerAssetSets:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego zestawy komponentów klienta są modyfikowane.

Treść żądania

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

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

object (CustomerAssetSetOperation)

To pole jest wymagane. Lista operacji do wykonania na poszczególnych zbiorach zasobów klienta.
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

Zmieniono wiadomość z odpowiedzią dotyczącą zestawu komponentów klienta.

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

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

object (MutateCustomerAssetSetResult)

Wszystkie wyniki dla mutacji.
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 (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 artykule Omówienie protokołu OAuth 2.0.

CustomerAssetSetOperation

Pojedyncza operacja (tworzenie, usuwanie) na zestawie komponentów klienta.

Zapis JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Pola
Pole sumy operation. Operacja zmiany. operation może mieć tylko jedną z tych wartości:
create

object (CustomerAssetSet)

Operacja tworzenia: nie oczekiwano nazwy zasobu dla nowego zestawu komponentów klienta.
remove

string

Operacja usuwania: oczekiwana jest nazwa zasobu usuniętego zestawu komponentów klienta w tym formacie: customers/{customerId}/customerAssetSets/{asset_set_id}

MutateCustomerAssetSetResult

Zmieniono wynik zestawu komponentów klienta.

Zapis JSON 
{
  "resourceName": string,
  "customerAssetSet": {
    object (CustomerAssetSet)
  }
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.
customerAssetSet

object (CustomerAssetSet)

Zmutowany komponent klienta zawierający tylko zmienne pola po przekształceniu. To pole zostanie zwrócone tylko wtedy, gdy responseContentType ma wartość „MUTABLE_RESOURCE”.