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/v14/{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

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

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

string

Dizi oluşturmayı zorunlu kılmak için kullanılan bir jeton.

Bir toplu iş için ilk groupJobs.addoperas isteği, stepsToken değerini ayarlamamalıdır. Sonraki istekler, nextSequenceToken değerine ayarlanması için önceki containerJobs.addoperas yanıtında alınan nextSequenceToken değerine ayarlamalıdır.
mutateOperations[]

object (MutateOperation)

Zorunlu. Eklenen mutasyonları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 "müşteriler/1234/kampanyalar/-1" olarak ayarlanmış bir kampanya, ikinci işlemde ise kampanya alanı da "müşteriler/1234/kampanyalar/-1" olarak ayarlanmış bir reklam grubu oluşturarak aynı kampanyada bir kampanya ve bir 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 işlemlerin toplam sayısı.
nextSequenceToken

string

Daha fazla işlem eklenmesi gerekirse topluJobs.addoperasyonlarını tekrar çağırırken kullanılacak sıra jetonu. Bir sonraki BundleJobs.addoperas isteğinde, stepsToken alanını bu alanın değerine ayarlamalısınız.

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.