Ottieni i limiti e l'utilizzo del piano Social

Indica cosa consente il tuo piano Social e quanto ne hai utilizzato. Consultalo prima di generare un link di connessione, così puoi informare un cliente che ha esaurito la capacità disponibile anziché mostrargli un SY95042 dovuto a un'operazione di scrittura non riuscita.

usage.connections è esattamente usage.connectionsActive + usage.connectionsReleased.

Uno slot rilasciato resta occupato fino alla fine del periodo

Scollegare un canale lo porta immediatamente offline, ma non rende nuovamente disponibile lo slot. Durante un periodo di fatturazione, il limite tiene conto delle connessioni distinte che hai utilizzato, indipendentemente dal fatto che siano ancora collegate, quindi lo slot resta occupato fino al rinnovo dell'abbonamento. Tre conseguenze di cui tenere conto nel codice:

• La capacità residua è maxConnections - usage.connections, mai maxConnections - usage.connectionsActive. Usare il conteggio delle connessioni attive farà credere a un cliente di avere capacità disponibile quando non ne ha, e il successivo link di connessione restituirà SY95042.
• Ricollegare lo stesso account allo stesso brand è gratuito. Se un cliente ricollega una Pagina che aveva scollegato da quel brand in precedenza nello stesso periodo, questa riutilizza lo slot che già occupa: connectionsActive aumenta, connectionsReleased diminuisce e connections rimane invariato. Collegare la stessa Pagina a un brand diverso occupa uno slot separato, e quello originale resta occupato fino al rinnovo.
• connectionsReleased è la tua previsione per il rinnovo. Indica esattamente quanti slot tornano disponibili nel pool all'inizio del ciclo successivo: è il dato da mostrare a un cliente che deve decidere se attendere il rinnovo o acquistare un pacchetto oggi.

Questo segue la stessa logica del resto del modello di fatturazione: la capacità che acquisti è disponibile immediatamente e quella a cui rinunci viene rimossa alla fine del ciclo. Vedi Piani e componenti aggiuntivi.

Caso d'uso: un controllo preliminare nel tuo flusso di onboarding. Prima di mostrare a un cliente il pulsante "collega un account", confronta usage.connections — il conteggio fatturabile, non connectionsActive — con maxConnections. Se non c'è capacità residua, mostragli come acquistare un componente aggiuntivo o passare a un piano superiore anziché lasciare che POST /social/brands/{brandId}/connections/link fallisca. Non esiste un controllo equivalente per i brand: la creazione di un brand con POST /social/brands non esaurisce mai la capacità disponibile.

Caso d'uso: determinare la dimensione del prossimo componente aggiuntivo. I pacchetti di connessioni vengono venduti in gruppi da 5, quindi maxConnections - usage.connections indica direttamente quanti social network puoi ancora collegare e ceil((needed - headroom) / 5) indica quanti pacchetti acquistare.

Note.

• I brand sono illimitati e non soggetti a conteggio ai fini della fatturazione. brands restituisce null per gli account listingsAPI. Il codice client che lo interpretava come un limite intero deve gestire null e non dovrebbe visualizzare "0 brand rimanenti".
• Le connessioni costituiscono un pool condiviso dall'intero account, non una quota per ciascun brand. Un brand può avere tutte le connessioni che desideri, fino ai 5 social network che supporta, purché il pool abbia capacità disponibile. Vedi Piani e componenti aggiuntivi.
• Questo endpoint riguarda solo l'abbonamento Social. I limiti delle sedi appartengono all'abbonamento Listings e vengono applicati separatamente da POST /locations, che restituisce SY10155 quando l'account non dispone di alcun piano Listings.
• Gli account self-service hanno un limite di 250 connessioni, indipendentemente dal numero di pacchetti acquistati. Per superarlo, l'account deve passare a Enterprise.
• La capacità disponibile non garantisce che Instagram possa essere collegato. Instagram consente solo un account Business o Creator collegato a una Pagina Facebook; un account personale viene rifiutato nella schermata di consenso di Meta, non a causa di questo limite. Se un cliente ha capacità disponibile qui e il link di connessione continua a non funzionare per Instagram, occorre convertire l'account anziché aumentare la capacità.
• I numeri sono aggiornati in tempo reale, ma un rilascio non è un rimborso. Lo scollegamento tramite disconnect o l'archiviazione di un brand si riflette qui alla lettura successiva, con una diminuzione di usage.connectionsActive e un aumento corrispondente di usage.connectionsReleased. usage.connections rimane invariato, perché lo slot resta occupato fino alla fine del periodo. Entrambe le modalità di rilascio si comportano allo stesso modo.