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/v16/{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 PartJobs.addOperations dla zadania wsadowego nie powinno ustawić parametru sessionToken. Kolejne żądania muszą ustawić parametr SequenceToken na wartość nextSequenceToken odebranej w poprzedniej odpowiedzi loadJobs.addOperations.
mutateOperations[]

object (MutateOperation)

To pole jest wymagane. Lista dodawanych mutacji.

Operacje mogą używać ujemnych liczb całkowitych jako tymczasowych identyfikatorów do określania zależności między elementami utworzonymi w tym zadaniu wsadowym. Na przykład klient z identyfikatorem = 1234 może utworzyć w tej samej kampanii kampanię i grupę reklam. W tym celu w pierwszej operacji utwórz kampanię z nazwą zasobu ustawioną na „customers/1234/campaigns/-1”, a w drugiej – z grupą reklam, w której pole kampanii będzie miało wartość „customers/1234/campaigns/-1”.

Treść odpowiedzi

Odpowiedź na pytanie: 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 podczas ponownego wywoływania operacjiBatchJobs.addOperations, jeśli trzeba dodać więcej operacji. Następne żądanie partJobs.addOperations musi ustawić w polu sekwencyjnToken wartość tego pola.

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.