Method: customers.batchJobs.addOperations

Tambahkan operasi ke tugas batch.

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

Permintaan HTTP

POST https://googleads.googleapis.com/v16/{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 memberlakukan 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 di antara entity yang dibuat dalam tugas batch ini. Misalnya, pelanggan dengan ID = 1234 dapat membuat kampanye dan grup iklan di kampanye yang sama tersebut dengan membuat kampanye di operasi pertama dengan nama fasilitas yang secara eksplisit ditetapkan 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 operasi lain perlu ditambahkan. Permintaan batchJobs.addOperations berikutnya harus menetapkan kolom sequenceToken ke nilai kolom ini.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.