Method: customers.batchJobs.addOperations

Dodaj operacje do zadania wsadowego.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/{resourceName=customers/*/batchJobs/*}:addOperations

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
resourceName

string

To pole jest wymagane. Nazwa zasobu zadania wsadowego.

Treść żądania

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

Zapis JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Pola
sequenceToken

string

Token używany do wymuszania sekwencjonowania.

Pierwsze żądanie partiiJobs.addOperations dla zadania wsadowego nie powinno ustawiać sekwencjiToken. Kolejne żądania muszą ustawiać SekwencjęToken na wartość parametru nextSequenceToken, która została odebrana w poprzedniej odpowiedzi PartdJobs.addOperations.
mutateOperations[]

object (MutateOperation)

To pole jest wymagane. Lista dodawanych mutacji.

Operacje mogą używać ujemnych liczb całkowitych jako tymczasowych identyfikatorów do oznaczania zależności między elementami utworzonymi w tym zadaniu wsadowym. Na przykład klient o identyfikatorze 1234 może utworzyć w tej samej kampanii kampanię i grupę reklam, tworząc w pierwszej operacji kampanię z nazwą zasobu ustawioną na „customers/1234/campaigns/-1”, a w drugiej z nich jako grupę reklam ustawioną na „customers/1234/campaigns/-1”.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: BatchJobService.AddBatchJobOperations.

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

Zapis JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Pola
totalOperations

string (int64 format)

Łączna liczba operacji dodanych do tej pory dla tego zadania wsadowego.
nextSequenceToken

string

Token sekwencji, który ma być używany przy ponownym wywoływaniu zadania fillJobs.addOperations, jeśli trzeba dodać więcej operacji. Następne żądanie partJobs.addOperations musi ustawić w polu sectionToken wartość tego pola.

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.