Ανάρτηση βίντεο σε Facebook Page μέσω του API
Ένα βίντεο φτάνει σε Facebook Page μέσω του POST /{page-id}/videos, είτε με file_url, ένα URL που η ίδια η Meta κατεβάζει, είτε με αρχείο που η εφαρμογή ανεβάζει πρώτα στη Meta. Το title ονομάζει το βίντεο, και το description είναι το κείμενο που η Meta μπορεί να εμφανίσει μαζί με την ανάρτηση. Στη συνέχεια η Meta επεξεργάζεται το αρχείο, και το GET /{video-id}?fields=status δείχνει το video_status ως processing έως ότου γίνει ready.
Το easyCoexistence δημοσιεύει βίντεο σε Facebook Pages με το publish_facebook_post από το Claude, το ChatGPT ή τον δικό σας κώδικα, άμεσα ή προγραμματισμένα έως 90 ημέρες μπροστά.
Κωδικός σφάλματος όταν η Meta δεν μπορεί να λάβει το αρχείο βίντεο από το URL που δίνεται στο file_url.
Κωδικός σφάλματος για αρχείο βίντεο πολύ μικρό για ανέβασμα· η Meta ζητά μεγαλύτερο αρχείο.
Εύρος για το scheduled_publish_time στο edge videos, μετρημένο από τη στιγμή που δημοσιεύεται το βίντεο.
Εύρος του processing_progress, του ποσοστού επεξεργασίας του βίντεο, που αναφέρεται δίπλα στο video_status.
Host για τα uploads βίντεο, σύμφωνα με την επισκόπηση Video API της Meta, η οποία χαρακτηρίζει το graph-video.facebook.com παρωχημένο γι' αυτά.
Το file handle που επιστρέφει ένα upload, το οποίο περνά στο /{page-id}/videos ως fbuploader_video_file_chunk για τη δημοσίευση του βίντεο.
Πώς δημοσιεύεται ένα βίντεο σε Page;
Με POST /{page-id}/videos και Page access token. Το αρχείο φτάνει στη Meta με έναν από δύο τρόπους: file_url, ένα προσβάσιμο URL του βίντεο που η ίδια η Meta ανακτά, ή ένα upload, όπου η εφαρμογή στέλνει πρώτα τα bytes. Το file_url δεν μπορεί να συνδυαστεί με το upload_phase, την παράμετρο της τμηματικής μεταφόρτωσης, οπότε ένα αίτημα χρησιμοποιεί τον έναν ή τον άλλον τρόπο.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
Πώς γίνεται το upload για αρχείο που δεν είναι online;
Ο οδηγός δημοσίευσης βίντεο της Meta χρησιμοποιεί το Resumable Upload API. Το POST /{app-id}/uploads με file_name, file_length και file_type ανοίγει μια συνεδρία, και το POST /upload:{session-id} με κεφαλίδα file_offset και τα bytes επιστρέφει ένα handle, h. Το βίντεο δημοσιεύεται έπειτα με POST /{page-id}/videos και fbuploader_video_file_chunk ίσο με εκείνο το handle, μαζί με τα title και description. Αυτές οι κλήσεις upload φέρουν user access token.
- Ένα διακοπτόμενο upload συνεχίζεται από το
file_offsetπου επιστρέφει το GET /upload:{session-id}. - Η αναφορά videos τεκμηριώνει και τμηματικό upload στο ίδιο edge:
upload_phasestart, transfer και finish, μεstart_offset,file_sizeκαιvideo_file_chunk.
Τι κάνουν το title και το description;
Το title είναι ο τίτλος του βίντεο. Το description είναι, με τα λόγια της Meta, το κείμενο που περιγράφει μια ανάρτηση και μπορεί να εμφανιστεί σε story σχετική με αυτή, άρα εκεί μπαίνουν τα λόγια της ανάρτησης. Και τα δύο είναι προαιρετικά στο edge videos, ενώ το publish_facebook_post στέλνει το μήνυμά του ως description και αφήνει το title χωρίς τιμή.
Πώς ξέρετε ότι το βίντεο είναι έτοιμο;
Η Meta επεξεργάζεται ένα βίντεο αφού φτάσει. Το GET /{video-id}?fields=status επιστρέφει το video_status, το οποίο γράφει processing όσο η Meta εργάζεται, ready μόλις το βίντεο ανέβει, κωδικοποιηθεί και αποκτήσει τις μικρογραφίες του, ή error αν η επεξεργασία απέτυχε, με το processing_progress να δίνει το ποσοστό που έχει ολοκληρωθεί, από 0 έως 100. Η Meta μπορεί επίσης να αναφέρει την κατάσταση δημοσίευσης μέσω των webhooks Page στο πεδίο videos, στα οποία το easyCoexistence δεν είναι εγγεγραμμένο.
Πόσο μεγάλο και πόσο διαρκές μπορεί να είναι το βίντεο;
Η αναφορά Page videos και ο οδηγός δημοσίευσης βίντεο της Meta δεν ορίζουν μέγιστο μέγεθος ή διάρκεια αρχείου· ο κανόνας μεγέθους που αναφέρουν είναι το σφάλμα 382, για αρχείο πολύ μικρό για ανέβασμα. Οι οδηγοί Reels και Stories της Meta ορίζουν δικές τους διάρκειες: από 3 έως 90 δευτερόλεπτα για ένα Reel και το πολύ 60 για βίντεο Story. Όταν το easyCoexistence προγραμματίζει ένα βίντεο, αντιγράφει το αρχείο εκείνη τη στιγμή και αρνείται αρχείο άνω του 1 GB.
Ποια δικαιώματα και ποια εργασία Page χρειάζονται;
pages_manage_posts, pages_read_engagement και pages_show_list, με Page token από κάποιον που μπορεί να εκτελεί την εργασία CREATE_CONTENT, σύμφωνα με την αναφορά videos και τον οδηγό δημοσίευσης. Η επισκόπηση Video API της Meta το διατυπώνει πιο αυστηρά: το πρόσωπο πρέπει να μπορεί να εκτελεί εργασίες ισότιμες με διαχειριστή στη Page, ή να έχει ρόλο Admin που έχει χορηγηθεί μέσω του Business Manager.
Ποια σφάλματα μπορεί να επιστρέψει μια ανάρτηση βίντεο;
Η αναφορά videos της Meta καταγράφει τα εξής για το POST /{page-id}/videos:
- 389: αδυναμία λήψης του αρχείου βίντεο από το URL.
- 382: το αρχείο βίντεο είναι πολύ μικρό· δοκιμάστε ξανά με μεγαλύτερο αρχείο.
- 6000: πρόβλημα κατά το ανέβασμα του αρχείου βίντεο· δοκιμάστε ξανά με άλλο αρχείο.
- 6001: πρόβλημα κατά το ανέβασμα του βίντεο· δοκιμάστε ξανά.
- 368: η ενέργεια θεωρήθηκε καταχρηστική ή είναι αλλιώς απαγορευμένη.
- 100: μη έγκυρη παράμετρος· 200: σφάλμα δικαιωμάτων· 190: μη έγκυρο OAuth 2.0 access token.
Πώς το publish_facebook_post δημοσιεύει βίντεο;
Δέχεται video_url, έναν δημόσιο σύνδεσμο HTTPS προς το αρχείο, και message, και τα στέλνει στο /{page-id}/videos ως file_url και description, ώστε η Meta να ανακτά μόνη της το βίντεο. Μια ανάρτηση περιέχει ένα βίντεο, και ένας σύνδεσμος που στέλνεται μαζί του απορρίπτεται, γι' αυτό βάλτε το URL μέσα στο message. Το post_id του αποτελέσματος κρατά το ID που επέστρεψε η Meta, το οποίο για βίντεο είναι το δικό του ID.
Πώς προγραμματίζεται μια ανάρτηση βίντεο;
Δώστε στο publish_facebook_post ένα scheduled_at σε ISO 8601 με ζώνη ώρας, από 1 λεπτό έως 90 ημέρες μπροστά. Το easyCoexistence αντιγράφει το βίντεο τη στιγμή που προγραμματίζεται η ανάρτηση και το δημοσιεύει στο Page εκείνη την ώρα. Το list_scheduled_posts το εμφανίζει, το update_scheduled_post το μετακινεί ή αλλάζει το κείμενό του, και το cancel_scheduled_post το σταματά. Το scheduled_publish_time της ίδιας της Meta στο edge videos επιτρέπει από 10 λεπτά έως 6 μήνες.
Συνηθισμένα λάθη
- Το file_url δείχνει σε σελίδα που παίζει το βίντεο και όχι στο ίδιο το αρχείο. Η Meta κατεβάζει τη διεύθυνση μόνη της, και μια διεύθυνση που δεν μπορεί να ανακτήσει αποτυγχάνει με το σφάλμα 389.
- Ανέβασμα στο graph-video.facebook.com. Η επισκόπηση Video API της Meta χαρακτηρίζει αυτό το host παρωχημένο για τα uploads βίντεο και ζητά το graph.facebook.com.
- Ανακοίνωση του βίντεο πριν είναι έτοιμο. Ελέγξτε την κατάσταση έως ότου το video_status γράψει ready, αφού η επεξεργασία συνεχίζεται μετά την επιστροφή της κλήσης δημοσίευσης.
- Αποστολή συνδέσμου μαζί με το βίντεο. Το publish_facebook_post απορρίπτει σύνδεσμο δίπλα σε αρχείο· γράψτε το URL μέσα στο message.
Η πλατφόρμα σας μπορεί να κάνει το ίδιο με POST /channels/:id/posts στο Partner API. US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορώ να ανεβάσω βίντεο από τον υπολογιστή μου σε Facebook Page μέσω του API;
Ναι, μέσω του Resumable Upload API της Meta, που επιστρέφει ένα handle για το /{page-id}/videos, ή του τμηματικού upload σε εκείνο το edge. Το publish_facebook_post δέχεται αντί γι' αυτό ένα δημόσιο URL HTTPS, οπότε φιλοξενήστε πρώτα το αρχείο.
Μπορεί ένα βίντεο να ανέβει χωρίς να εμφανιστεί στη ροή της Page;
Ναι. Το published ορισμένο σε false κρατά την ανάρτηση πίσω, το no_story καταργεί την ιστορία στη ροή και στο timeline, και το secret κρατά το βίντεο εκτός Facebook και εκτός αναζήτησης.
Μπορεί ένα βίντεο να δημοσιευτεί σε πολλές Pages;
Ναι, με crossposting: ένα δημοσιευμένο βίντεο μπορεί να μεταδοθεί σε άλλες Pages που διαχειρίζεται το πρόσωπο, χωρίς νέο ανέβασμα, και αποκτά δικό του video ID σε κάθε Page.
Πόσο κοστίζει το easyCoexistence για μια Facebook Page;
US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, ανάλογα με το συνολικό πλήθος των συνδέσεών σας, με τις πρώτες 3 ημέρες δωρεάν. Κάθε Page είναι μία σύνδεση.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις