Social planı sınırlarını ve kullanımını alın

Social planınızın nelere izin verdiğini ve bu hakların ne kadarını kullandığınızı bildirir. Bir bağlantı oluşturma bağlantısı vermeden önce bu bilgileri okuyun; böylece başarısız bir yazma işleminden kaynaklanan SY95042 hatasını göstermek yerine müşteriye kapasitesinin dolduğunu söyleyebilirsiniz.

usage.connections tam olarak usage.connectionsActive + usage.connectionsReleased değerine eşittir.

Serbest bırakılan bir kontenjan, dönem sonuna kadar ayrılmış durumda kalır

Bir kanalın bağlantısını kesmek, kanalı hemen çevrimdışı yapar ancak kontenjanı geri vermez. Bir faturalandırma dönemi içinde üst sınır, hâlâ bağlı olup olmadıklarına bakılmaksızın kullandığınız farklı bağlantıları sayar; bu nedenle kontenjan, abonelik yenilenene kadar kullanılmış olarak kalır. Kodunuzda dikkate almanız gereken üç sonuç:

• Kalan kapasite maxConnections - usage.connections değeridir, asla maxConnections - usage.connectionsActive değildir. Etkin bağlantı sayısını kullanmak, müşteriye gerçekte sahip olmadığı bir boş kapasitesi olduğunu söyler ve bir sonraki bağlantı oluşturma bağlantısı SY95042 döndürür.
• Aynı hesabı aynı markaya yeniden bağlamak ücretsizdir. Bir müşteri, dönem içinde daha önce o markadan bağlantısını kestiği bir Sayfayı yeniden bağlarsa bu işlem zaten ayrılmış olan kontenjanı yeniden kullanır: connectionsActive artar, connectionsReleased azalır ve connections değişmez. Aynı Sayfayı farklı bir markaya bağlamak ayrı bir kontenjan kullanır ve ilk kontenjan yenilemeye kadar ayrılmış durumda kalır.
• connectionsReleased, yenileme öngörünüzdür. Döngü yenilendiğinde havuza geri dönecek kontenjan sayısını tam olarak gösterir; yenilemeyi beklemek ile bugün bir paket satın almak arasında karar veren müşteriye gösterilmesi gereken bilgi budur.

Bu, faturalandırma modelinin geri kalanıyla aynı şekilde işler: satın aldığınız kapasite hemen kullanılabilir hâle gelir ve vazgeçtiğiniz kapasite döngünün sonunda kaldırılır. Planlar ve eklentiler bölümüne bakın.

Kullanım örneği: ilk kurulum akışınızda bir ön kontrol. Müşteriye "hesap bağla" düğmesini sunmadan önce, usage.connections değerini — connectionsActive değil, faturalandırılan sayıyı — maxConnections ile karşılaştırın. Kalan kapasite yoksa POST /social/brands/{brandId}/connections/link işleminin başarısız olmasına izin vermek yerine müşteriye eklenti veya plan yükseltme seçeneğini gösterin. Markalar için eşdeğer bir kontrol yoktur: POST /social/brands ile marka oluştururken kapasite hiçbir zaman tükenmez.

Kullanım örneği: bir sonraki eklentinin boyutunu belirleme. Bağlantı paketleri beşer bağlantılık olarak satılır; dolayısıyla maxConnections - usage.connections doğrudan daha kaç ağı bağlayabileceğinizi, ceil((needed - headroom) / 5) ise kaç paket satın almanız gerektiğini gösterir.

Notlar.

• Markalar sınırsızdır ve kullanımları ölçülmez. listingsAPI hesapları için brands, null olarak döner. Bunu tamsayı türünde bir üst sınır olarak ele alan istemci kodu, null değerini işlemeli ve "0 marka kaldı" ifadesini göstermemelidir.
• Bağlantılar, marka başına bir hak değil, hesap genelinde paylaşılan bir havuzdur. Havuzda yer olduğu sürece bir marka, desteklediği beş ağla sınırlı olmak üzere istediğiniz kadar bağlantı barındırabilir. Planlar ve eklentiler bölümüne bakın.
• Bu uç nokta yalnızca Social aboneliğini kapsar. Konum üst sınırları Listings aboneliğine aittir ve POST /locations uç noktasında ayrı olarak uygulanır; bu uç nokta, hesabın hiçbir Listings planı olmadığında SY10155 döndürür.
• Self servis hesaplar, kaç paket satın alınırsa alınsın 250 bağlantıyla sınırlıdır. Bu sayının üzerine çıkmak için hesabın Enterprise planına geçmesi gerekir.
• Boş kapasite, Instagram'ın bağlanacağını garanti etmez. Instagram yalnızca bir Facebook Sayfasına bağlı İşletme veya İçerik Üreticisi hesabına izin verir; kişisel bir hesap bu üst sınır nedeniyle değil, Meta'nın onay ekranında reddedilir. Müşterinin burada boş kapasitesi varsa ve bağlantı oluşturma bağlantısı Instagram için yine de başarısız oluyorsa daha fazla kapasite yerine hesabın dönüştürülmesi gerekir.
• Sayılar anlıktır, ancak bir bağlantının serbest bırakılması ücret iadesi değildir. disconnect ile bağlantının kesilmesi veya bir markanın arşivlenmesi, bir sonraki okumada buraya yansır: usage.connectionsActive azalır ve usage.connectionsReleased aynı miktarda artar. Kontenjan dönem sonuna kadar ayrılmış durumda kaldığı için usage.connections değişmez. Her iki serbest bırakma yöntemi de aynı şekilde davranır.