Method: customers.batchJobs.addOperations

Toplu işe işlem ekleyin.

Atılan hataların listesi: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
resourceName

string

Zorunlu. Toplu işin kaynak adı.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "sequenceToken": string,
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ]
}
Alanlar
sequenceToken

string

Diziyi uygulamak için kullanılan bir jeton.

Bir toplu iş için ilkBatchJobs.addOperations isteği, rangeToken ayarlamamalıdır. Sonraki istekler, stepsToken özelliğini önceki BundleJobs.addoperas yanıtında alınan nextSequenceToken değerine ayarlamalıdır.
mutateOperations[]

object (MutateOperation)

Zorunlu. Eklenen mutatların listesi.

İşlemler, bu toplu işte oluşturulan varlıklar arasındaki bağımlılıkları belirtmek için geçici kimlikler olarak negatif tam sayılar kullanabilir. Örneğin, kimliği 1234 olan bir müşteri, ilk işlemde kaynak adı açık bir şekilde "customers/1234/campaigns/-1" olarak ayarlanmış bir kampanya, ikinci işlemde ise kampanya alanı da "customers/1234/campaigns/-1" olarak ayarlanmış bir reklam grubu oluşturarak aynı kampanyada kampanya ve reklam grubu oluşturabilir.

Yanıt gövdesi

BatchJobService.AddBatchJobOperations için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "totalOperations": string,
  "nextSequenceToken": string
}
Alanlar
totalOperations

string (int64 format)

Bu toplu iş için şimdiye kadar eklenen toplam işlem sayısı.
nextSequenceToken

string

Daha fazla işlem eklenmesi gerekirse privateJobs.addoperasyonlarını tekrar çağırırken kullanılacak sıra jetonu. Bir sonraki businessJobs.addoperasyon isteğinde, rankToken alanı bu alanın değerine ayarlanmalıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.