Słownik

Czym jest token dostępu do Strony na Facebooku i dlaczego zaczyna się od człowieka

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Token dostępu do Strony na Facebooku wydany na podstawie logowania użytkownika przez endpoint accountsToken dostępu do Strony na Facebooku wydany na podstawie logowania użytkownika przez endpoint accounts

TL;DR, szybka odpowiedź

9 min czytania

Meta opisuje token dostępu do Strony na Facebooku jako poświadczenie, które pozwala aplikacji "read, write, and modify data belonging to a Facebook Page." Nie można poprosić o niego bezpośrednio. Najpierw zdobywasz User access token od osoby, która może wykonać zadanie na Stronie, a potem wywołujesz GET /{user-id}/accounts, co zwraca po jednym tokenie na Stronę. Token Strony utworzony z krótkotrwałego User tokena jest krótkotrwały. Token utworzony z długotrwałego User tokena nie ma daty wygaśnięcia. Strony Meta poświęcone Pages API nie zgadzają się ze sobą ani w opisie wygasania, ani w nazwie jednego z wymaganych uprawnień.

Czym jest token dostępu do Strony na Facebooku?

Meta definiuje token dostępu do Strony na Facebooku jako poświadczenie, które pozwala aplikacji działać jako Strona, a nie jako osoba. Przewodnik po tokenach dostępu ujmuje to w jednym zdaniu: "Page access tokens let you read, write, and modify data belonging to a Facebook Page." Publikowanie w kanale Strony, odpowiadanie na komentarze w jej imieniu i odczyt Page Insights opierają się właśnie na tym tokenie.

Meta wymienia na tej samej stronie pięć typów tokenów, a token Strony jest jedynym powiązanym z jedną konkretną Stroną:

Typ tokenaCo według Meta robiJak go zdobyć
User access tokenOdczytuje lub zapisuje "a person's Facebook data on their behalf"Okno logowania, w którym osoba przyznaje uprawnienia
Page access tokenOdczytuje, zapisuje i modyfikuje "data belonging to a Facebook Page"Wymiana User tokena przez Graph API
System User access tokenWykonuje "automated actions on Ad objects or Pages without requiring input from an app user or re-authentication"Ustawienia firmy, System Users, Generate token
App access tokenOdczytuje i modyfikuje ustawienia aplikacjiWywołanie po stronie serwera z użyciem app secret
Client tokenIdentyfikuje aplikację w wywołaniach na poziomie aplikacji z aplikacji natywnych lub desktopowychApp Dashboard, nie jest tajny

Token Strony to także ten, o który Pages API prosi wprost. Przegląd Pages API od Meta mówi "Most endpoints require Page access tokens," a tabela błędów Pages API ma osobny kod na wywołanie takiego endpointu czymkolwiek innym: 190 z podkodem 2069032, "A Page access token is required for this call."

Jak zdobyć token dostępu do Strony?

Token dostępu do Strony dostajesz w zamian za User access token. Instrukcja Meta ma dwa kroki: "To obtain one, first get a user access token, then exchange it for a Page access token via the Graph API." Nie istnieje endpoint, który wydałby token Strony aplikacji, która wcześniej nie zalogowała żadnej osoby.

Wymiana to jedno żądanie GET do krawędzi accounts danej osoby:

curl -i -X GET "https://graph.facebook.com/{your-user-id}/accounts?access_token={user-access-token}"

Meta podaje, że wywołanie "returns a list of Pages you have a role on, including the Page category, your permissions on each Page, and the Page access token." Każdy obiekt w tablicy data zawiera access_token, category, category_list, name, id oraz tablicę tasks:

{
  "data": [
    {
      "access_token": "EAACEdE...",
      "category": "Brand",
      "name": "Ash Cat Page",
      "id": "1353269864728879",
      "tasks": ["ANALYZE", "ADVERTISE", "MODERATE", "CREATE_CONTENT", "MANAGE"]
    }
  ]
}

Przegląd Pages API opisuje ten sam proces w czterech krokach: zdobądź User access token "through Facebook Login for Business," odpytaj /me/accounts, zapisz zwrócone ID Strony i token, a następnie "use the ID and token to query the Page node." Jedno logowanie może zwrócić kilka Stron. W takim przypadku Meta zaleca programistom "capture each Page ID and its respective token", bo każda Strona dostaje własny ciąg znaków.

Osoba sprawdza smartfon przy biurku, co symbolizuje osobiste logowanie, od którego zależy token Strony.

Dlaczego publikowanie na Stronie firmowej wymaga osobistego logowania do Facebooka?

Publikowanie na Stronie firmowej wymaga osobistego logowania, bo token Strony dziedziczy uprawnienia po konkretnej osobie. Przegląd Meta określa ten warunek tak: "In order to get a token from an app User, the app User must own or be able to perform a Task on the Page." Sama Strona nigdzie się nie loguje. Loguje się osoba, która ma na niej rolę, a token zapamiętuje, kto to był.

Meta opisuje to powiązanie nieco inaczej na dwóch aktualnych stronach. Przewodnik po tokenach dostępu mówi, że tokeny Stron "are unique to each Page, admin, and app combination." Przegląd Pages API mówi, że są "unique to each Page, app User, and app." W praktyce wychodzi na to samo. Zmień Stronę, osobę albo aplikację, a dostaniesz inny token. Jeśli osoba, która połączyła Stronę, straci rolę, wywołania wykonywane jej tokenem przestają przechodzić sprawdzenie zadania, co jest jedną z przyczyn opisanych w tekście o tym, dlaczego narzędzie do planowania postów ciągle się rozłącza.

Jedyna droga bez osobistego logowania to system user. Konfiguracja Facebook Login for Business pozwala aplikacji poprosić o "a User access token or System-user access token." Jeśli wybierzesz User token, "your app users will log in using their personal Facebook account." Jeśli wybierzesz token system usera, "will be required to log in using a business portfolio", co według Meta "is only required if this configuration needs continuous access to business assets, such as Facebook Pages." Tokeny system usera wymagają, by portfolio firmowe było właścicielem Strony lub miało do niej udostępniony dostęp, więc pasują agencjom i zespołom wewnętrznym ze skonfigurowanym Business Managerem, a nic nie dają samodzielnemu twórcy, którego Strona jest przypięta do profilu osobistego.

Dwa sposoby logowania po token Strony
Osobiste logowanie do Facebooka
  • Użytkownicy aplikacji logują się osobistym kontem na Facebooku
  • Aplikacja dostaje token dostępu użytkownika
  • Sprawdza się u samodzielnego twórcy, którego Strona jest przypięta do profilu osobistego
Logowanie przez portfolio firmowe
  • Użytkownicy aplikacji logują się przez portfolio firmowe
  • Aplikacja dostaje token dostępu użytkownika systemowego
  • Portfolio musi być właścicielem Strony lub mieć do niej udostępniony dostęp
  • Pasuje agencjom i zespołom wewnętrznym z Business Managerem
Tylko droga przez portfolio firmowe pozwala uniknąć osobistego logowania.

Jakich uprawnień potrzebuje token dostępu do Strony?

Aby publikować, token dostępu do Strony potrzebuje dwóch odrębnych zgód: uprawnień, które osoba zatwierdza dla aplikacji, oraz zadania, które ta osoba ma przypisane na Stronie. Meta sprawdza oba warunki. Przegląd tłumaczy drugi z nich: "we will first check if the User has been approved for a task that permits that type of action."

Oto uprawnienia Strony, o które prosi integracja publikująca, z opisami Meta z dokumentacji uprawnień:

UprawnienieNa co według Meta pozwalaZależy od
pages_show_list"access the list of Pages a person manages"Brak
pages_manage_posts"create, edit and delete your Page posts"pages_read_engagement, pages_show_list
pages_read_engagement"read content (posts, photos, videos, events) posted by the Page," a także dane o obserwujących i metadanepages_show_list
pages_manage_metadata"subscribe and receive webhooks about activity on the Page, and to update settings on the Page"pages_show_list
pages_manage_engagement"create, edit and delete comments posted on the Page"pages_read_user_content, pages_show_list

Zadania zwracane w tablicy tasks odpowiadają konkretnym działaniom. CREATE_CONTENT pozwala osobie "Publish content as the Page on the Page." MODERATE obejmuje odpowiadanie na komentarze i ich usuwanie. ANALYZE obejmuje Insights. MANAGE pozwala "Assign and manage Page tasks." Meta dodaje: "If a person is given Admin access to a Page in the UI, that person is able to perform all tasks on that Page." Jeśli aplikacja ma pages_manage_posts, ale osoba nie ma CREATE_CONTENT, Pages API zwraca 1 z podkodem 2853006, "Viewer doesn't have permission to perform this action."

Przewodniki Meta różnią się w jednej nazwie. Przewodnik Get Started do Pages API wymienia cztery uprawnienia do pierwszego posta: pages_manage_metadata, pages_manage_posts, pages_manage_read_engagement i pages_show_list. W dokumentacji uprawnień nie ma jednak pozycji pages_manage_read_engagement. Przewodnik Manage a Page podaje zamiast tego pages_read_engagement, i tę samą zależność dokumentacja wskazuje dla pages_manage_posts. Proś o pages_read_engagement.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Nad tym wszystkim stoi App Review. Przegląd mówi: "All Page-related Permissions and Features require approval through the App Review process before your app can use them when your app goes live." Aplikacje w trybie deweloperskim mogą prosić o dowolne uprawnienie, ale tylko osoby mające rolę w aplikacji.

Klepsydra na biurku symbolizuje czas ważności tokena dostępu do Strony.

Czy token dostępu do Strony na Facebooku wygasa?

Token dostępu do Strony na Facebooku wygasa w tym samym terminie co User token, z którego powstał, chyba że użyjesz długotrwałego User tokena. Wtedy token Strony przestaje mieć datę wygaśnięcia. Obie części tej reguły pochodzą od Meta, tyle że z różnych stron.

Źródłowy User tokenWynikowy token StronySformułowanie Meta
Krótkotrwały, z logowania w przeglądarceKrótkotrwały/accounts zwraca "a short-lived Page access token" (przewodniki Get Started i Manage a Page)
Długotrwały, z fb_exchange_tokenDługotrwały, bez daty wygaśnięcia"Long-lived Page access token do not have an expiration date and only expire or are invalidated under certain conditions"

Przegląd Pages API dodaje trzecie stwierdzenie, które do tej tabeli nie pasuje. Mówi, że tokeny dostępu do Strony "have an expiration time", bez zastrzeżenia dla wariantu długotrwałego. Strona o tokenach długotrwałych twierdzi coś odwrotnego w odniesieniu do tokenów pochodzących z długotrwałego User tokena. Traktuj zdanie z przeglądu jako opis domyślnego tokena krótkotrwałego i zanim zaufasz którejkolwiek ze stron, sprawdź prawdziwy token przez debug_token. Wywołanie wymiany, wartość expires_in równą 5183944 i pola debug_token omawiamy w tekście o długotrwałym tokenie dostępu Facebooka i jego 60-dniowym zegarze.

"Brak daty wygaśnięcia" nie oznacza, że token jest wieczny. Ogólne zastrzeżenie Meta dotyczące czasu życia tokenów obowiązuje także tutaj: "Do not depend on these lifetimes remaining the same," bo "they may change without warning or expire early." Przewodnik Meta po debugowaniu wymienia udokumentowane przyczyny. Osoba, która "logged out of your app or changed their password", dostaje kod 190 z podkodem 460, a aplikacja, której osoba cofnęła autoryzację, podkod 458. Każda z tych sytuacji kończy życie tokena Strony, który nigdy nie miał daty ważności.

Jak kończy się token bez daty wygaśnięcia
Wylogowanie lub zmiana hasłaKod 190, podkod 460
Cofnięcie autoryzacji aplikacjiKod 190, podkod 458
Zmiana czasu życiaMeta zastrzega, że może się zmienić bez ostrzeżenia lub skończyć wcześniej
Brak daty wygaśnięcia nie gwarantuje, że token będzie działał.

Czy token dostępu do Strony zmienia działanie limitów zapytań?

Tak. Wywołania wykonane tokenem dostępu do Strony liczą się do innego limitu niż wywołania z User tokenem. Meta mierzy żądania Pages API wykonane tokenem Strony lub system usera w ramach limitu business use case, Calls within 24 hours = 4800 * Number of Engaged Users, gdzie engaged users to osoby, "who engaged with the Page per 24 hours." Żądania wykonane tokenami User lub tokenami aplikacji podlegają natomiast starszemu limitowi platformy. Wzór i nagłówek X-Business-Use-Case-Usage wyjaśniamy w tekście o limicie business use case Meta dla Stron.

Najczęściej zadawane pytania

Jaki endpoint zwraca token dostępu do Strony?

GET /{user-id}/accounts lub GET /me/accounts, wywołany z User access tokenem. Odpowiedź zawiera po jednym obiekcie na Stronę z polami access_token, name, id, category oraz tasks, czyli zadaniami, które osoba może wykonywać na tej Stronie.

Czy można zdobyć token dostępu do Strony bez osobistego konta na Facebooku?

Tylko przez system usera. Konfiguracje Facebook Login for Business mogą prosić o token system usera, a to wymaga logowania przez portfolio firmowe. Żeby to zadziałało, portfolio musi być właścicielem Strony albo mieć do niej dostęp.

Czy token dostępu do Strony jest taki sam dla każdego administratora?

Nie. Meta podaje, że tokeny dostępu do Strony "are unique to each Page, admin, and app combination." Dwóch administratorów, którzy łączą tę samą aplikację z tą samą Stroną, generuje dwa różne tokeny.

Dlaczego mój token Strony podobno nigdy nie wygasa, a mimo to przestał działać?

Meta podaje, że długotrwałe tokeny Stron "only expire or are invalidated under certain conditions." Przewodnik po debugowaniu wiąże podkod 460 z osobą, która "logged out of your app or changed their password", a podkod 458 z aplikacją, której osoba już nie autoryzuje. Oba przypadki kończą ważność tokena, choć żadna data nie nadeszła.

Które uprawnienie pozwala aplikacji publikować na Stronie?

pages_manage_posts, które według Meta pozwala aplikacji "create, edit and delete your Page posts." Zależy ono od pages_read_engagement i pages_show_list, a osoba musi też mieć na Stronie zadanie CREATE_CONTENT.

Jaki błąd pojawia się po wywołaniu endpointu Strony User tokenem?

Pages API zwraca kod 190 z podkodem 2069032 i komunikatem "A Page access token is required for this call." Użyj tokena Strony z odpowiedzi /accounts i spróbuj ponownie.

Czym różni się token dostępu użytkownika od tokena dostępu do Strony?

Token dostępu użytkownika odczytuje lub zapisuje "a person's Facebook data on their behalf", a token dostępu do Strony odczytuje, zapisuje i modyfikuje "data belonging to a Facebook Page". Token użytkownika dostajesz z okna logowania i wymieniasz go na token Strony przez /accounts. Większość endpointów Pages API wymaga tokena Strony.

Czy token dostępu do Strony wymaga App Review?

Tak, zanim aplikacja trafi do użytkowników. Meta podaje, że wszystkie uprawnienia i funkcje związane ze Stronami wymagają wtedy zatwierdzenia w App Review. W trybie deweloperskim aplikacja może prosić o dowolne uprawnienie, ale tylko osoby mające w niej rolę.

Co dzieje się z tokenem Strony, gdy administrator, który go połączył, traci rolę?

Wywołania tym tokenem przestają przechodzić sprawdzenie zadania, które wcześniej je przepuszczało. Tokeny Stron są unikalne dla każdej kombinacji Strony, administratora i aplikacji, więc token należy do tej osoby. Ponowne połączenie przez kogoś, kto nadal ma odpowiednie zadanie, daje inny token.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Jak sprawdzić, czy token dostępu do Strony jest nadal ważny?

Przepuść go przez debug_token i odczytaj wynik, zamiast ufać któremuś ze stwierdzeń Meta o wygasaniu. Dotyczy to także tokenów bez daty wygaśnięcia, bo wylogowanie, zmiana hasła lub cofnięcie autoryzacji mogą je unieważnić.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły