Facebook Reels API: Reelsien julkaiseminen Sivulle
Facebook Reels API julkaisee Reelsin Sivulle kolmessa vaiheessa: POST /{page-id}/video_reels upload_phase-arvolla start palauttaa video_id:n, video lähetetään osoitteeseen rupload.facebook.com ja POST /{page-id}/video_reels upload_phase-arvolla finish ja video_state-arvolla PUBLISHED julkaisee sen. Metan määritys on 9:16-videota, 3–90 sekuntia pitkä, ja Sivu voi julkaista 30 Reelsiä API:n kautta 24 tunnin liukuvalla jaksolla.
easyCoexistence julkaisee videoita Facebook-sivulle tavallisina videojulkaisuina publish_facebook_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi tekstin, linkkien ja kuvien rinnalla.
API:n kautta julkaistujen Reelsien määrä Sivua kohden 24 tunnin liukuvalla jaksolla, rajoitus toteutetaan kohteessa POST /{page_id}/video_reels.
Reelsin kesto, jonka Meta hyväksyy; Sivulla tarinana julkaistu Reels ei saa ylittää 60 sekuntia.
Pienin Reels-resoluutio; Meta suosittelee 1080 x 1920 pikseliä kuvasuhteella 9 x 16.
Kauimmainen ajankohta, johon scheduled_publish_time voi ajastaa Reelsin, vähintään 10 minuuttia päähän, video_state-arvolla SCHEDULED.
Virhekoodi Reelsille, jonka kestoa Facebook ei tue; Reelsien on oltava 3–90 sekuntia.
Miten Reels API julkaisee Reelsin?
Kolmessa vaiheessa kahdessa isännässä. Aloitus- ja viimeistelykutsut menevät Sivun video_reels-päätepisteeseen osoitteeseen graph.facebook.com, kun taas itse video menee osoitteeseen rupload.facebook.com, aloituskutsun palauttamaan upload_url-osoitteeseen. Videon tunnuksella tehtävä tilatarkistus lähetyksen ja viimeistelyn välissä näyttää, onko Meta saanut koko tiedoston ja käsitellyt sen.
Millainen video Reelsin pitää olla?
Meta julkaisee Reelsien vaatimukset Reels Publishing -oppaassa. Lataus, joka ei täytä kuvasuhteen, resoluution, keston tai kuvataajuuden vaatimuksia, hylätään omalla virhekoodillaan. Sivun tarinana julkaistavan Reelsin on myös pysyttävä 60 sekunnissa.
Miten video ladataan?
Lähetetään POST-pyynnöllä upload_url-osoitteeseen palvelimella rupload.facebook.com, ja mukana kulkee Sivun tokenin Authorization: OAuth -otsakkeessa. Koneesi tiedosto lähetetään pyynnön runkona, ja offset-otsake asetetaan arvoon 0 ja file_size tiedoston kooksi tavuina. Verkossa jo oleva tiedosto lähetetään sen sijaan file_url-otsakkeella, ja Meta hakee sen itse. Onnistunut lataus palauttaa success-arvon true.
file_urlhyväksyy http- ja https-osoitteet; todennusta vaativat URL-osoitteet eivät ole tuettuja.- Isännän on sallittava facebookexternalhit/1.1-user agentin hakea tiedosto, sillä Meta hylkää tiedostot sivuilta, jotka estävät sen robots.txt-tiedostossa.
- Metan omalta CDN:ltä olevat tiedostot, kuten fbcdn-osoitteet, hylätään; Meta neuvoo ristijulkaisemaan videon, jos sen haluaa toiselle Sivulle.
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"Miten Reelsin tilan voi tarkistaa?
GET-pyyntö osoitteeseen /{video-id}?fields=status palvelimelle graph.facebook.com. Vastaus sisältää video_status-kentän, jonka arvo on uploading, upload_complete, processing, ready, upload_failed, expired tai error, sekä yhden olion jokaista vaihetta kohden: uploading_phase kenttineen bytes_transfered, processing_phase virheviesteineen ja publishing_phase kentillä publish_status (draft, scheduled, published tai error) ja publish_time. Kunkin vaiheen oma tila on not_started, in_progress, completed tai error.
Miten keskeytynyt lataus jatketaan?
Lähettämällä latauksen POST-pyyntö uudelleen siten, että offset-otsakkeena on tilatarkistuksen uploading_phase.bytes_transfered-arvo eli tavumäärä, jonka Meta on jo saanut. Offset, jota Meta ei hyväksy, palauttaa virheen OffsetInvalidError, ja rungon pituus, joka ei vastaa tiedoston pituutta, palauttaa PartialRequestError. Jos uudelleen lataaminen ei toimi, Metan neuvo on aloittaa alusta ensimmäisestä vaiheesta.
Mitä viimeistelykutsu vaatii?
Aloituskutsun video_id:n, upload_phase-arvon finish ja video_state-arvon PUBLISHED, DRAFT tai SCHEDULED. description sisältää tekstin ja tukee hashtageja. title, place sijaintisivulle sekä is_ai_generated, joka ilmoittaa Reelsin luoneen tai muokanneen tekoäly, ovat valinnaisia. Ajastettu Reels lisää scheduled_publish_time-kentän, UNIX-aikaleiman, joka on yli 10 minuuttia ja enintään 29 päivää eteenpäin. Meta vastaa success-arvolla true.
Kuinka monta Reelsiä Sivu voi julkaista API:n kautta?
30 Reelsiä 24 tunnin liukuvalla jaksolla. Meta valvoo rajaa kohteessa POST /{page_id}/video_reels Reelsin julkaisun yhteydessä ja suosittelee, että sovellukset valvovat sitä myös itse, erityisesti sovellukset, jotka antavat ihmisten ajastaa julkaisuja myöhemmäksi. Yhteistyökumppanikutsuilla on oma rajansa: 10 Sivua kohden 24 tunnissa. Virhe 613 on video_reels-ohjeessa, ja se tarkoittaa, että kutsut tähän API:hin ovat ylittäneet nopeusrajoituksen.
Mitä käyttöoikeuksia ja Sivun tehtävää tarvitaan?
Sivun käyttöoikeustoken henkilöltä, joka voi suorittaa Sivulla CREATE_CONTENT-tehtävän, ja Facebook Loginin kautta myönnetyt pages_show_list, pages_read_engagement ja pages_manage_posts. Meta pyytää myös, että sovellukset näyttävät käyttäjälle ilmoituksen siitä, miten hänen Reelsejään käytetään Facebookissa, vaihtoehdoilla hallita sitä, ja tarjoavat vain Public-yleisön, sillä julkaisu Sivulle sisältää implisiittisen julkisen laajuuden.
Mitä virheitä Reels API palauttaa?
Koodi 100 tarkoittaa, että pakollinen parametri puuttuu, kuten upload_phase, ja Metan viesti luettelee puuttuvat. Neljä muuta koodia hylkäävät videon, joka ei täytä määrityksiä:
- 1363040: kuvasuhde ei ole tuettu; videoiden on oltava 16x9 ja 9x16 välillä.
- 1363127: resoluutio ei ole tuettu; vähimmäisresoluutio on 540 x 960 pikseliä.
- 1363128: kesto ei ole tuettu; Reelsien kesto on 3–90 sekuntia.
- 1363129: keskimääräinen kuvataajuus ei ole tuettu; Reelsit tarvitsevat 24–60 kuvaa sekunnissa.
Miten Sivun Reelsit listataan?
GET-pyynnöllä osoitteeseen /{page-id}/video_reels, joka palauttaa Sivun julkaistut Reelsit tunnuksineen, päivitysaikoineen ja kuvauksineen. since ja until rajaavat listan päivämääriin, jotka annetaan muodossa today, yesterday, UNIX-aikaleima tai yyyy-mm-dd, ja until-arvon on oltava since-arvon jälkeen. Metan syötteen ohje osoittaa tähän päätepisteeseen Sivulle julkaistujen Reelsien kohdalla.
Miten julkaiset Reelsin easyCoexistencen kautta?
Ei Reelinä tällä hetkellä. publish_facebook_post lähettää videot Sivun videos-päätepisteeseen tavallisina videojulkaisuina, eikä easyCoexistencessa ole työkalua video_reels-kutsuille; Sivun tokeneita ei luovuteta, joten kolmea vaihetta ei voi ajaa omasta koodistasi sen yhteydelläkään. Julkaise Reel Facebookissa tai Meta Business Suitessa tai julkaise video tavallisena videojulkaisuna.
Yleiset virheet
- Latauksen lähettäminen osoitteeseen graph.facebook.com. Video menee osoitteeseen rupload.facebook.com Authorization: OAuth -otsakkeella, ja graph.facebook.com on vain aloitus-, viimeistely- ja tilakutsuja varten.
- Tiedoston sijoittaminen paikkaan, josta Meta ei pääse hakemaan sitä. file_url kirjautumisen takana, sivustolla, jonka robots.txt estää facebookexternalhit/1.1-agentin, tai fbcdn-osoitteessa hylätään.
- Keskeytyneen latauksen aloittaminen alusta. Lue ensin tila: uploading_phase.bytes_transfered on jatkamisen offset, ja uusi istunto on viimeinen keino.
- Yli 30 Reelsin jonottaminen yhdelle Sivulle päivässä. Meta laskee API:n kautta julkaistut Reelsit 24 tunnin liukuvalla jaksolla, joten levitä ajastetut tasaisesti.
Sillä ei ole työkalua Reels API:lle, joten Reel julkaistaan Facebookissa tai Meta Business Suitessa. US$ 9–US$ 0,75 yhteydeltä kuukaudessa, hinta laskee yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Voiko Reelsin julkaista API:n kautta Facebook-profiiliin tai ryhmään?
Ei. Metan Reels Publishing API julkaisee Reelsit vain Facebook-sivuille, ja ristijulkaisu tehdään vain sivuille.
Julkaiseeko publish_facebook_post Reelsejä?
Ei. Se julkaisee tekstin, linkit, kuvat ja videot Sivulle. Reels vaatii video_reels-kutsut, joita easyCoexistencen työkalut eivät tee.
Miten tarkistan Reelsin tekijänoikeusosumat?
Lue GET /{video-id}?fields=copyright_check_information pages_read_engagement-oikeuksilla. Meta ajaa tarkistuksen latauksen yhteydessä, se voi kestää muutaman minuutin, ja vain omistaja näkee osumat.
Voiko toinen Sivu julkaista myös minun Reelsini?
Kyllä, yhteistyökumppanina. POST /{video-id}/collaborators, jonka target_id on heidän Sivunsa tunnus, lähettää kutsun, ja kun he hyväksyvät, Reelsi ilmestyy myös heidän Sivulleen.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu