Method: customers.batchJobs.addOperations

Menambahkan operasi ke tugas batch.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
resourceName

string

Wajib. Nama resource tugas batch.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Kolom
sequenceToken

string

Token yang digunakan untuk menerapkan pengurutan.

Permintaan batchJobs.addOperations pertama untuk tugas batch tidak boleh menetapkan sequenceToken. Permintaan berikutnya harus menetapkan sequenceToken ke nilai nextSequenceToken yang diterima dalam respons batchJobs.addOperations sebelumnya.
mutateOperations[]

object (MutateOperation)

Wajib. Daftar mutasi yang ditambahkan.

Operasi dapat menggunakan bilangan bulat negatif sebagai ID sementara untuk menunjukkan dependensi antar-entitas yang dibuat dalam tugas batch ini. Misalnya, pelanggan dengan ID = 1234 dapat membuat kampanye dan grup iklan di kampanye yang sama dengan membuat kampanye dalam operasi pertama dengan nama resource yang ditetapkan secara eksplisit ke "customers/1234/campaigns/-1", dan membuat grup iklan dalam operasi kedua dengan kolom kampanye juga ditetapkan ke "customers/1234/campaigns/-1".

Isi respons

Pesan respons untuk BatchJobService.AddBatchJobOperations.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Kolom
totalOperations

string (int64 format)

Jumlah total operasi yang ditambahkan sejauh ini untuk tugas batch ini.
nextSequenceToken

string

Token urutan yang akan digunakan saat memanggil batchJobs.addOperations lagi jika ada operasi lain yang perlu ditambahkan. Permintaan batchJobs.addOperations berikutnya harus menetapkan kolom sequenceToken ke nilai kolom ini.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/adwords

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.