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/v17/{resourceName=customers/*/batchJobs/*}:addOperations

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
resourceName

string

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 waitJobs.addOperations dla zadania wsadowego nie powinno ustawiać tokena sekwencyjnego. Kolejne żądania muszą ustawić sekwencyjny token na wartość nextSequenceToken otrzymanej w poprzedniej odpowiedzi w baterJobs.addOperations.
mutateOperations[]

object (MutateOperation)

Wymagane. Lista mutacji dodawanych.

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ć kampanię i grupę reklam w tej samej kampanii, tworząc kampanię w pierwszej operacji z nazwą zasobu wyraźnie ustawioną na „customers/1234/campaigns/-1”, a w drugiej operacji tworząc grupę reklam z polem kampanii ustawionym także na „customers/1234/campaigns/-1”.

Treść odpowiedzi

Wiadomość z odpowiedzią dla: 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 stronybatJobs.addOperations, jeśli trzeba dodać więcej operacji. Następne żądanie babyJobs.addOperations musi ustawić w polu sectionToken na 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.