Czym jest Facebook API?
Facebook API to zestaw rozwiązań służących jako główny sposób na pobieranie i wysyłanie danych z platformy. Umożliwia deweloperom i użytkownikom aplikacji dostęp do funkcji tego serwisu: informacji o użytkownikach, zdjęć i filmów, wiadomości i wielu innych.
BONUS: Stwórz swój widget z Facebook Feed w kilka minut!
Jak zdobyć klucz API Facebooka.
Aby uzyskać dostęp do klucza API Facebooka, musisz zarejestrować się lub zalogować na swoje istniejące konto Facebook na portalu dla deweloperów i potwierdzić swoją tożsamość. Wymaga to wykonania kilku prostych kroków:
- Krok 1. Zaloguj się lub załóż konto
Przejdź do portalu dla deweloperów Facebooka i kliknij „Zaloguj się”. Możesz zalogować się na istniejące konto Facebook lub utworzyć nowe.
- Krok 2. Rozpocznij
Po wejściu do serwisu kliknij „Rozpocznij” w prawym górnym rogu strony głównej.
- Krok 3. Zweryfikuj swoje konto
Aby zacząć korzystać z narzędzi deweloperskich, musisz potwierdzić swoje konto. W wyskakującym okienku kliknij „Dalej”.
Możesz zweryfikować konto za pomocą numeru telefonu lub karty kredytowej. Aby to zrobić przez telefon, wybierz kraj z listy, wpisz numer telefonu z kodem kraju i kliknij „Wyślij SMS”. Wprowadź otrzymany kod w pole i kliknij „Zweryfikuj”.
- Krok 4. Stwórz swoją aplikację
Następnie serwis zaproponuje utworzenie pierwszej aplikacji. Wszystkie API i statystyki aplikacji Facebooka są zarządzane w panelu deweloperskim, do którego dostęp uzyskuje się po utworzeniu aplikacji.
- Krok 5. Dodaj aplikacje lub wygeneruj tokeny dostępu według potrzeb
Najprostszy i najwygodniejszy sposób korzystania z Facebook API to dodanie aplikacji bezpośrednio w panelu. Wybierz tę, która odpowiada Twoim potrzebom.
Przejdź do Narzędzia – Graph API Explorer, aby wygenerować tokeny dostępu dla różnych typów API, które chcesz wykorzystać w swojej aplikacji. Wybierz aplikację i rodzaj tokena z rozwijanych menu po lewej stronie ekranu, a następnie kliknij „Generate Access Token”. Będziesz musiał zatwierdzić dostęp aplikacji do swojej strony.
Przykłady użycia Facebook API
Głównym produktem jest Graph API, które stanowi podstawę dla wszystkich innych rodzajów Facebook API. Są one w istocie rozszerzeniami Graph API, a wszystkie produkty Facebooka w pewien sposób z nim współpracują.
Jak można wykorzystać konsolę deweloperską Facebooka i dostępne tam produkty? Istnieje wiele sposobów na wzbogacenie swojej strony lub aplikacji o treści i funkcje tego serwisu społecznościowego.
Możesz wyświetlać różne rodzaje treści z mediów społecznościowych – posty, zdjęcia, filmy – na swojej stronie lub w aplikacji, aby angażować i bawić użytkowników.
Pamiętaj jednak, że gdy Graph API jest wykorzystywane przez innych użytkowników, muszą oni najpierw zatwierdzić dostęp w wyskakującym okienku. Dopiero po autoryzacji aplikacja otrzyma token dostępu od użytkownika i będzie mogła korzystać z jego danych z profilu Facebook.
Limity Facebook API
Każdy typ API ma swoje ograniczenia. Zapytania Graph API wykonywane z użyciem tokena dostępu aplikacji są liczone w ramach limitu wywołań tej aplikacji. Liczba wywołań na godzinę jest obliczana według wzoru:Wywołania w ciągu godziny = 200 * liczba użytkowników aplikacji
Integracja Facebook API
Platforma oferuje kilka gotowych rozwiązań dla osób niebędących programistami, opartych na Graph API. Wszystkie aplikacje i API Facebooka to w gruncie rzeczy zestaw węzłów Graph API. Oznacza to, że nadal musisz wykonać kroki 1-3 opisane powyżej, aby założyć konto i uzyskać dostęp do panelu. Poniżej opisujemy najczęściej używane standardowe aplikacje Facebook API.
Typy Facebook Feed API
Facebook Page API
Ten typ API umożliwia dostęp do ustawień, treści i statystyk strony. Pozwala tworzyć i wyświetlać posty, komentarze ze strony, treści należące do strony i więcej. Szczegóły znajdziesz w dokumentacji Pages API. Pamiętaj, że potrzebujesz tokena od użytkownika aplikacji, który jest właścicielem strony lub ma odpowiednie uprawnienia.
Facebook Video API
Facebook oferuje dwa typy: Video API oraz Live Video API. Oba służą do publikowania filmów na stronie, w grupie lub wydarzeniu zarządzanym przez użytkownika aplikacji. Video API służy do publikowania krótkich i długich filmów na jednej lub wielu stronach i grupach. Live Video API umożliwia planowanie transmisji na żywo, streamowanie wideo na profil użytkownika, grupę lub wydarzenie oraz interakcję z widzami. Oczywiście potrzebujesz tokenów dostępu do stron, grup lub wydarzeń, w zależności od miejsca publikacji.
Facebook API Events
Ten rodzaj API jest dostępny tylko dla partnerów marketingowych Facebooka i wymaga tokena dostępu od administratora wydarzenia lub grupy, która je utworzyła.
Facebook News Feed API
Masz dwie opcje dostępu do Facebook news feed. Opisane Graph API pozwala na dostęp do osobistego kanału użytkownika z aktualizacjami statusów oraz pobieranie postów i linków publikowanych przez użytkownika lub inne osoby na profilu. Więcej informacji znajdziesz tutaj.
Istnieje też Public Feed API, które umożliwia wyświetlanie treści oznaczonych jako „Publiczne” na zewnętrznych serwisach lub stronach. Ten typ API jest jednak przyznawany tylko zatwierdzonym wydawcom mediów, więc trzeba najpierw złożyć wniosek.
Nie potrzebujesz Facebook Group API, aby wyświetlać jego zawartość na swojej stronie. Skorzystaj z widgetu Facebook Feed! Dzięki niemu masz pełną kontrolę nad wyświetlanymi treściami.
Facebook Community API
Facebook Comment API
Dostęp do komentarzy na Facebooku uzyskuje się przez Graph API. Ponieważ komentarze mogą być dodawane pod różnymi typami treści, musisz mieć dostęp do obiektu, aby móc nimi zarządzać.
Facebook Reviews API
Ta część Graph API reprezentuje obiekty zawierające rekomendacje. Domyślne pola to data, ocena gwiazdkowa, tekst recenzji, informacje o użytkowniku oraz oznaczenie „pozytywna” lub „negatywna”.
Jeśli chcesz mieć większą kontrolę nad wyświetlanymi recenzjami, możesz dostosować plugin recenzji według własnych potrzeb.
Facebook Tools APIs
Facebook Login API
Przykład logowania przez Facebook API można zobaczyć na wielu serwisach wymagających rejestracji. Umożliwia to szybkie i bezpieczne logowanie do strony lub aplikacji. API zbiera tokeny dostępu użytkowników, aby pobrać ich dane profilowe, co jest możliwe tylko po ich zgodzie. Aby korzystać z tego API, musisz przejść proces weryfikacji i zatwierdzenia aplikacji przez Facebook.
Facebook Places API
Places Graph to osobne rozwiązanie Facebooka dostępne tylko na platformy Android i iOS. Dzięki niemu Twoja aplikacja może uzyskać informacje o aktualnej lokalizacji użytkownika. Umożliwia też wyszukiwanie miejsc, udostępnianie lokalizacji i geotagowanie. Places API wymaga tokenów dostępu od użytkowników. Aby zintegrować i zacząć korzystać z Places API, najpierw pobierz Facebook SDK dla swojej aplikacji.
Facebook Payments API
API płatności zawiera szczegóły płatności dokonanych w danej aplikacji. Płatności te są realizowane przez system Facebook Payments i przetwarzane na platformie. Ten typ API wymaga tokena dostępu dla aplikacji, która tworzy płatność.
Facebook Messenger API
Messenger API to aplikacja umożliwiająca organizację kanału rozmów na Twojej stronie za pomocą Facebook Messenger. Rozwiązanie to pozwala deweloperowi tworzyć prowadzone konwersacje z użytkownikami. Dzięki temu Messenger może automatycznie odpowiadać użytkownikowi za pomocą Send API (zwanego też Facebook Bot API), które wysyła webhooki na adres serwera, gdzie hostowany jest Messenger.
Pozostań w kontakcie z klientami i odwiedzającymi Twoją stronę dzięki darmowemu i łatwemu w instalacji przyciskowi Messengera!
Typy Facebook marketing API
Facebook Ads API
Marketing API to zestaw punktów końcowych Graph API, które pomagają optymalizować reklamy na Facebooku. Facebook Ads API umożliwia tworzenie i zarządzanie kampaniami reklamowymi, zestawami reklam oraz pojedynczymi jednostkami reklamowymi.
Facebook Marketplace API
Obecnie na Facebook Marketplace dostępne są tylko kategorie Pojazdy i Nieruchomości. Aby uzyskać dostęp do tej części platformy, musisz założyć konto dewelopera i zweryfikować swoją firmę. Rozwiązanie to pozwala korzystać z Lead API wraz z webhookami deweloperskimi dla lepszej wydajności. W tym celu musisz stworzyć aplikację, jak opisano wcześniej, i przesłać ją do weryfikacji przez Facebook.
Facebook Analytics API
To rozwiązanie pomaga śledzić i optymalizować zachowania oraz ścieżki klientów z urządzeń mobilnych, stron www, botów, offline i innych źródeł. Aby je wdrożyć, musisz zintegrować Facebook SDK ze swoją aplikacją lub stroną. Więcej informacji znajdziesz w Centrum pomocy Analytics.
Facebook Business Manager API
Ten typ API pomaga zarządzać wieloma stronami, kontami reklamowymi i aplikacjami w jednym miejscu. W Business Manager możesz łączyć zasoby firmowe i uprawnienia, zarządzać uprawnieniami, prowadzić kampanie w imieniu firmy, tworzyć konta reklamowe i kupować reklamy.
Najnowsze zmiany w API
Zmiany w Facebook API obejmują wersjonowane aktualizacje – wprowadzane wraz z nowymi wersjami API – oraz zmiany niewersjonowane, pojawiające się poza standardowymi wydaniami. Aby przejść na wyższą wersję API, dostępne jest specjalne narzędzie do aktualizacji API.
Najświeższa wersja to v8.0, wydana w sierpniu 2020 roku. Zawiera ona m.in.:
- typy aplikacji – Biznes, Gry i Brak
- możliwość zdobywania polubień dla transmisji na żywo
- szablon produktu w Messengerze dla sklepów do wysyłania produktów jako wiadomości
Poprzednia wersja v7.0, wydana w maju 2020, będzie dostępna do sierpnia 2022 roku.
Status i błędy Facebook API
Aktualny status platformy jest stabilny od 1 października 2020. Jednak zapytania czasem zwracają różne błędy Facebook API z odpowiednimi kodami. Na przykład błąd 400 – Nieprawidłowe żądanie – oznacza, że zapytanie nie jest już obsługiwane i trzeba wygenerować nowy token dostępu. Oto kilka innych kodów:
| Kod | Nazwa |
| 102 | Sesja API |
| 1 | Nieznane API |
| 2 | Serwis API |
| 3 | Metoda API |
| 4 | Zbyt wiele wywołań API |
| 17 | Użytkownik API – zbyt wiele wywołań |
| 10 | Odmowa uprawnień API |
| 190 | Token dostępu wygasł |
| 200-299 | Uprawnienia API (różne w zależności od uprawnienia) |
| 341 | Osiągnięto limit aplikacji |
| 368 | Tymczasowa blokada za naruszenia zasad |
| 506 | Duplikat posta |
| 1609005 | Błąd podczas publikacji linku |
Dokumentacja Facebook API
Dokumentację wszystkich rodzajów Facebook API dla deweloperów znajdziesz w sekcji Docs na portalu dla deweloperów Facebooka. Pełna lista głównych węzłów Graph API dostępna jest w referencji Facebook API. Każda dokumentacja zawiera krótki poradnik dotyczący wymaganych uprawnień oraz sposobu użycia i implementacji, dostępny w sekcjach „Getting Started” i „Guides” dla konkretnego API.
