Method: customers.adGroupAssetSets.mutate

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

Żądanie HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, którego zestawy komponentów grup 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)

Wymagane. Lista operacji do wykonania na poszczególnych zestawach komponentów grup reklam.
partialFailure

boolean

Jeśli wartość to prawda, operacje zakończą się powodzeniem, a nieprawidłowe operacje zwrócą błędy. Jeśli wartość jest równa fałsz, wszystkie operacje zostaną wykonane w ramach jednej transakcji, o ile wszystkie są prawidłowe. Wartość domyślna to fałsz.
validateOnly

boolean

Jeśli to prawda, żądanie jest sprawdzane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki.
responseContentType

enum (ResponseContentType)

Ustawienie typu treści odpowiedzi. Określa, czy po zmianie ma zostać zwrócony zasób z możliwością zmiany, czy tylko nazwa zasobu.

Treść odpowiedzi

Odpowiedź na zmianę komponentów w separaturze grup 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 operacji zamiany.
partialFailureError

object (Status)

Błędy dotyczące niepowodzeń operacji w trybie częściowego niepowodzenia. Zwracany tylko wtedy, gdy partialFailure = true i wszystkie błędy występują wewnątrz operacji. Jeśli wystąpią błędy poza operacjami (np. błędy uwierzytelniania), zwracamy 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 (tworzenie lub usuwanie) na zbiorze 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 unii operation. Operacja zmiany. operation może być tylko jednym z tych elementów:
create

object (AdGroupAssetSet)

Operacja tworzenia: nowy zestaw komponentów grupy reklam nie wymaga podawania nazwy zasobu.
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.

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

string

Zwracany w przypadku pomyślnych operacji.
adGroupAssetSet

object (AdGroupAssetSet)

Zmutowany zestaw komponentów grupy reklam z tylko zmiennymi polami po zmutowaniu. Pole zostanie zwrócone tylko wtedy, gdy parametr responseContentType ma wartość „MUTABLE_RESOURCE”.