Toplu gönderi oluşturma

Tek bir istekte çok sayıda sosyal medya gönderisi oluşturur. Satırlar istek yükünde iletilir — dosya yükleme veya CSV yoktur; yalnızca POST /social/posts tarafından tek tek alınan nesnelerle aynı yapıdaki nesnelerden oluşan bir dizi vardır. Her istekte en fazla 500 satır gönderilebilir.

Kullanım senaryosu: bir çağrıda 3 aylık içerik yükleme. Planlama aracınızda müşterinin tüm içerik takvimi bulunur. Her zaman dilimi için bir satır oluşturun, her birini kendi clientReference değerinizle etiketleyin ve birlikte gönderin. Toplu işlem ya bir bütün olarak başarılı olur ya da tam olarak hangi satırları düzeltmeniz gerektiğini bildirir. Döndürülen job.id değerini saklayın ve status nihai bir duruma ulaşana kadar GET /social/bulk-posts/{bulkJobId} üzerinden düzenli aralıklarla sorgulama yapın, ardından her sonucu kendi clientReference değeriyle eşleştirin.

Toplu işlemin tamamı önceden doğrulanır

Herhangi bir şey oluşturulmadan önce tüm satırlar doğrulanır ve bu aşamada toplu işlem atomiktir:

• Herhangi bir satır geçersizse hiçbir şey oluşturulmaz. success değeri false olur, SY95050 değeri error içinde döndürülür ve her hatalı satır, 0 tabanlı index değeri, clientReference değeri ve errors[] içindeki hata nedeni ile birlikte job.results[] içinde yer alır. Bu satırları düzeltin ve toplu işlemin tamamını yeniden gönderin.
• Her satır geçerliyse bir iş kuyruğa alınır, success değeri true olur ve bir job.id alırsınız. Platform, satırları yayımlama sırasında reddederse tek tek satırlar daha sonra yine de başarısız olabilir; bu durum burada değil, iş üzerinde görünür.

Mümkün olduğunda clientReference değerine, aksi durumda index değerine göre eşleştirme yapın — satırların kendileri yanıtta geri döndürülmediğinden, kendi verilerinizle bağlantı kurmanızı sağlayan yalnızca bu 2 alandır.

Notlar.

• İstek gövdesi, satırlar input.posts içinde olacak şekilde bir input nesnesiyle sarmalanmalıdır.
• HTTP durumunu değil, success değerini kontrol edin. Toplu işlemin tamamının reddedilmesi, success: false ve error içinde SY95050 içeren bir HTTP 200 olarak döndürülür.
• Her istekte en fazla 500 satır gönderilebilir. Daha büyük bir dizi SY95048 ile doğrudan reddedilir ve hiçbir şey oluşturulmaz; diziyi bölün ve birkaç toplu işlem halinde gönderin.
• Her satırdaki marka socialProfileId ile belirtilir. brandId yalnızca bir URL yolu belirtecidir ve bu rotada hiçbir yol belirteci yoktur.
• Satırlar farklı markaları hedefleyebilir. Her satırın platforms değerleri o satırın kendi markasına göre kontrol edilir; bu nedenle, bir markaya bağlı olup diğerine bağlı olmayan bir platform, yalnızca kendisine ihtiyaç duyan satırların başarısız olmasına neden olur.
• Her satır, tek bir gönderiyle aynı zamanlama kurallarına uyar: scheduledAt veya scheduleDate + scheduleTime kullanılır, asla ikisi birden kullanılmaz ve scheduleDate / scheduleTime değerleri o satırın markasının saat diliminde yorumlanır. Bir toplu işlemde farklı satırlarda bu 2 biçimin birlikte kullanılması uygundur.
• İstek hızı sınırları satırlara değil, isteğe uygulanır: 500 satırlık bir toplu işlem, kotanızdan bir istek tüketir. Bkz. İstek hızı sınırları.

Yazma işlemi: canlı hesapta yürütülmemiştir. Gösterilen istek ve yanıt, API şemasından oluşturulmuştur; bu işlem çalıştırıldığında gerçek sosyal medya hesaplarında yayın yapar.