Sosyal medya gönderisi oluşturun

Bir marka için, markanın bağlı sosyal medya hesaplarından birinde veya birkaçında tek bir gönderi oluşturur. Aynı çağrı üç yaşam döngüsünü de kapsar: DRAFT kaydetme, SCHEDULE kuyruğa alma veya hemen PUBLISH.

Kullanım örneği: kendi takviminizden bir kampanya zamanlama. Uygulamanız, bir müşterinin ne söylemek istediğini ve bunu ne zaman söylemek istediğini zaten bilir. Her zaman dilimi için bu uç noktayı action: "SCHEDULE" ve scheduledAt ya da scheduleDate + scheduleTime ile çağırın ve döndürülen UUID'yi saklamadan eşleştirme yapabilmek için kendi zaman dilimi tanımlayıcınızı clientReference olarak iletin. GET /social/posts/{postId}, gönderinin tüm kanallarda yayımlandığını bildirene kadar kaydı beklemede olarak gösterin ve POST /social/posts/cancel çağrısını yapan bir iptal düğmesi sunun.

Yayımlama eşzamansızdır

action: "PUBLISH", yanıt vermeden önce gönderiyi yayımlamaz. Çağrı gönderiyi kabul eder, bir socialPostId döndürür ve gönderiyi yayımlama sürecine aktarır. Gerçekte ne olduğunu öğrenmek için GET /social/posts/{postId} uç noktasını düzenli aralıklarla sorgulayın ve kanal bazındaki channels[] dizisini okuyun: her kaydın status değeri, ilgili platformdaki sonucu gösterir. Aynı istekte bir gönderi Instagram'da başarıyla yayımlanırken LinkedIn'de başarısız olabilir; bu nedenle channels[] gerçek durumu gösterir, gönderi düzeyindeki status ise bir özettir.

Zamanlama seçimi

action: "SCHEDULE", iki biçimden tam olarak birini gerektirir; ikisi birden kullanılamaz:

Her ikisini birden göndermek, scheduleDate alanını scheduleTime olmadan göndermek veya saat farkı içermeyen bir scheduledAt göndermek, SY95046 ile reddedilir. DRAFT ve PUBLISH hiçbir şekilde zamanlama içermemelidir.

Notlar.

• İstek gövdesi bir input nesnesi içine alınmalıdır.
• HTTP durumunu değil, success değerini kontrol edin. Doğrulama hataları, success: false ve error dizisinde her sorun için bir kayıt içeren HTTP 200 olarak döndürülür. success değeri false olduğunda hiçbir şey oluşturulmaz.
• Marka, gövdede socialProfileId ile tanımlanır. brandId yalnızca bir URL yolu belirtecidir; hiçbir zaman gövde alanı değildir.
• platforms içindeki her platformun markada önceden kurulmuş bir bağlantısı olmalıdır. Etkin kanalı olmayan bir platform SY95045 ile başarısız olur; önce markanın bağlantılarını okuyun ve eksik olan her bağlantı için kullanıcıyı bir bağlantı kurma bağlantısına yönlendirin.
• Platform değerleri, büyük harfli enum adları olan FACEBOOK, INSTAGRAM, TWITTER, LINKEDIN ve PINTEREST değerleridir. TWITTER, X'i ifade eder; değer eski adını korumuştur ve küçük harfli bir değer reddedilir.
• Instagram ve Pinterest, yalnızca metin içeren bir gönderiyi kabul etmez: platforms içinde bu platformlardan biri varsa en az bir mediaUrls kaydı sağlayın.
• Gönderi kimlikleri, konum gönderilerinde kullanılan Base64 relay kimlikleri değil, düz UUID'lerdir.
• Tek seferde birkaç gönderiden fazlası için aynı satır yapısını kabul eden ve tüm grubu baştan doğrulayan POST /social/bulk-posts uç noktasını kullanın.

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 gönderi yayımlar.