Method: customers.adGroupAssetSets.mutate

Tworzy lub usuwa zestawy komponentów grupy reklam. Stany operacji są zwracane.

Żądanie HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/adGroupAssetSets: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 grupy reklam są modyfikowane.

Treść żądania

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

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

object (AdGroupAssetSetOperation)

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

Zmieniono wiadomość z odpowiedzią na zestaw komponentów w grupie reklam.

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

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

object (MutateAdGroupAssetSetResult)

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 jakiekolwiek błędy wystąpią poza operacją (np. błędy uwierzytelniania), zostanie zwrócony 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.

AdGroupAssetSetOperation

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

Zapis JSON 
{

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

object (AdGroupAssetSet)

Operacja tworzenia: nie oczekiwana jest nazwa zasobu dla nowego zestawu komponentów grupy reklam.
remove

string

Operacja usuwania: oczekiwana jest nazwa zasobu usuniętego zestawu komponentów grupy reklam, w tym formacie: customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

MutateAdGroupAssetSetResult

Wynik dla zestawu komponentów grupy reklam ulega zmianie.

Zapis JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.
adGroupAssetSet

object (AdGroupAssetSet)

Zestaw komponentów grupy reklam zmutowanych, który po przekształceniu zawiera tylko pola zmienne. Pole zostanie zwrócone tylko wtedy, gdy responseContentType ma wartość „MUTABLE_RESOURCE”.