Method: customers.adGroupAssetSets.mutate

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

Żądanie HTTP

POST https://googleads.googleapis.com/v14/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 komponentów grupy reklam.
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

Wiadomość odpowiedzi dotycząca mutacji zestawu komponentów grupy 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 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.

AdGroupAssetSetOperation

Pojedyncza operacja (utworzenie, usunięcie) 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 mieć 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

Zmieniono wynik zestawu komponentów grupy reklam.

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

string

Zwracany w przypadku udanych operacji.
adGroupAssetSet

object (AdGroupAssetSet)

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