即時文章API

此API 允許您直接從內容管理系統建立、發佈、更新和刪除即時文章。

在Facebook 上也會即時以即時文章格式執行自動化發佈。

只有在網站上也可公開瀏覽的新動態，才 ... 即時文章立即開始設計文章文章範例編排範本格式CreateArticle匯入文章行動呼籲單位獲利來源Subscriptions政策使用說明常見問題詞彙表部落格即時文章API即時文章支援使用即時文章API同步發佈。

此API允許您直接從內容管理系統建立、發佈、更新和刪除即時文章。

在Facebook上也會即時以即時文章格式執行自動化發佈。

只有在網站上也可公開瀏覽的新動態，才會透過即時文章API發佈。

即時文章系統必須存取每篇文章的標準網址，才可正確呈現內容。

API使用簡介以下為如何使用即時文章API設定自動化發佈的步驟：1.建立Facebook應用程式編號您需要現有的Facebook應用程式編號，這會用於向即時文章API發出呼叫。

如果還沒有應用程式編號，請新建一個。

2.使用API發表新文章即時文章API可用於將文章發表至Facebook粉絲專頁的即時文章庫。

透過此API，您可直接從內容管理系統建立、更新和刪除即時文章。

如需即時文章API端點的詳細指引，請參閱即時文章API參考資料。

在開始將此API整合至發佈系統前，圖形API測試工具能協助您熟悉如何使用即時文章API。

3.驗證文章是否已正確處理再次檢查文章，確認是否毫無錯誤且正確呈現。

如需疑難排解和排除錯誤的指示，請參閱測試與偵錯一節。

4.更新已發佈的文章有時您會想要更新之前發佈的文章內容，例如在持續報導某則新聞動態的情況下。

若要自動指定文章以更新和重新發佈，文章的HTML必須包含op-published和op-modified元素，並且必須透過API重新發表更新的文章。

只有在影音素材的網址變更時，與文章相關的影音素材才會更新。

5.確保Facebook網路爬蟲可觸及您的內容若要將內容正確發表至即時文章，請確保我們的網路爬蟲能夠看到您的內容。

如果您通常會限制對內容的存取權，則必須將我們的網路爬蟲加入許可清單中。

如需瞭解如何識別我們的網路爬蟲和加入許可清單的建議方式，請參閱Facebook網路爬蟲指南。

6.提交文章進行審查在文章範例成功通過文章審查程序後，您就能開始發佈即時文章。

在此之前，您無法發佈即時文章。

需求開始使用即時文章API之前，您必須具備下列項目：現有的Facebook粉絲專頁（用於發佈即時文章）。

如果還沒有粉絲專頁，請新建一個。

現有的Facebook應用程式編號（用於向即時文章API發出呼叫）。

如果還沒有應用程式編號，請新建一個。

驗證所有即時文章要求都必須以粉絲專頁存取權杖簽署，透過這個方式您就可代表Facebook粉絲專頁發出API要求。

您只可代表在Facebook粉絲專頁具備管理員角色的用戶來產生粉絲專頁存取權杖。

下列步驟描述產生有效粉絲專頁存取權杖的方法，以便使用該存取權杖來發出即時文章要求。

1.產生用戶存取權杖為了產生粉絲專頁存取權杖，您必須先建立用戶存取權杖，方法是透過您的應用程式來驗證用戶，並且要求延長的pages_manage_instant_articles和pages_show_list權限。

用戶存取權杖是透過「Facebook登入」對話方塊產生，這個對話方塊會提示用戶將pages_manage_instant_articles和pages_show_list權限授予您的應用程式。

您可以使用FacebookJavaScriptSDK來叫用「登入」對話方塊，或者手動建立您自己的登入流程。

成功產生有效的用戶存取權杖之後，您需要將這個權杖傳輸到您的伺服器，以延長權杖的使用壽命，並擷取粉絲專頁存取權杖。

如需有關如何產生用戶存取權杖的詳細資訊，請參閱用戶權杖文件。

2.交換長期權杖驗證流程產生的用戶存取權杖只能維持約一兩個小時，所以您需要延長權杖的使用壽命，以保持向即時文章API持續發出要求的能力。

產生有效的用戶存取權杖之後，您就可以使用這個權杖來交換長期用戶存取權杖，後者可讓您接著用於擷取不會到期的粉絲專頁存取權杖。

從伺服器發出以下呼叫，以使用短期使用者存取權杖來交換長期權杖：GET/oauth/access_token? grant_type=fb_exchange_token& client_id={app-id}& client_secret={app-secret}& fb_exchange_token={short-lived-token}您可以在應用程式主控板找到應用程式的「應用程式編號」和「應用程式密鑰」。

如需有關產生長期權杖的詳細資訊，請參閱存取權杖文件。

3.擷取粉絲專頁存取權杖產生長期用戶存取權杖之後，您就可以擷取永不到期的粉絲專頁存取權杖。

發出以下呼叫，這個呼叫會傳回用戶有存取權的粉絲專頁清單，並連帶傳回該粉絲專頁的粉絲專頁存取權杖：GET/{user-id}/accounts如果該用戶管理多個粉絲專頁，您就需要按粉絲專頁編號來查詢粉絲專頁權杖：{ "data":[ { "category":"Product/service", "name":"SamplePage", "access_token":"{access-token}", "id":"1234567890", "perms":[ "ADMINISTER", "EDIT_PROFILE", "CREATE_CONTENT", "MODERATE_CONTENT", "CREATE_ADS", "BASIC_ADMIN" ] }, }從所需粉絲專頁的access_token欄位擷取粉絲專頁存取權杖，然後將這個權杖儲存在伺服器上，以便代表該用戶向即時文章API發出要求。

列出所有文章若要取得針對特定Facebook粉絲專頁所建立的文章編號完整清單，請向以下網址發出GET要求：https://graph.facebook.com/{page-id}/instant_articles欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串after傳回這個指定游標（做為分頁用途）之後的文章。

整數before傳回這個指定游標（做為分頁用途）之前的文章。

整數development_mode傳回開發模式的文章。

布林值要求範例GEThttps://graph.facebook.com/{page-id}/instant_articles?access_token={access-token}回應範例{ "data":[ { "id":"1234", "html_source":"...", "canonical_url":"http://..." }, { "id":"1235", "html_source":"...", "canonical_url":"http://..." }, { "id":"1236", "html_source":"...", "canonical_url":"http://..." }, ... }, "paging":{ "cursors":{ "before":"1a2B3c4D5e6F7g8H9i0J", "after":"1A2b3C4d5E6f7G8h9I0j" }, "next":"https://graph.facebook.com/{page-id}/instant_articles?access_token=...&pretty=1&limit=25&after=1A2b3C4d5E6f7G8h9I0j" } }查詢文章編號若要根據即時文章的標準網址來查詢其文章編號，請向以下網址發出GET要求：https://graph.facebook.com?id={canonical-url}&fields=instant_article欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串id[必要項目]即時文章的標準網址。

網址fields[必要項目]用於指定文章來源：生產或開發。

若是生產中的文章版本，此參數值必須包含instant_article。

若是開發中的文章版本，此參數必須包含development_instant_article。

字串要求範例GEThttps://graph.facebook.com?id={canonical-url}&fields=instant_article&access_token={access-token}回應範例{ "instant_article":{ "id":"1234" }, "id":"http://www.mysite.com/myarticle" }取得文章詳細資訊若要根據即時文章的文章編號來取得個別即時文章的詳細資訊，請向以下網址發出GET要求：https://graph.facebook.com/{article-id}欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串要求範例GEThttps://graph.facebook.com/{article-id}?access_token={access-token}回應範例{ "id":"1234", "html_source":"...", "canonical_url":"http://..." }建立新文章若要建立新的即時文章，請向以下網址發出POST要求：POST/{page-id}/instant_articles欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串html_source[必要項目]文章的完整HTML標記。

字串published指定是否應將這篇文章上線。

此欄位為選用，預設值為false。

布林值development_mode指定是否應以開發模式發佈這篇文章。

此欄位為選用，預設值為false。

布林值要求範例curl\ -F'access_token={access-token}'\ -F'html_source=...'\ -F'published=true'\ -F'development_mode=false'\ https://graph.facebook.com/{page-id}/instant_articles回應範例{ "id":{import-status-id} }文章透過此端點發表之後，Facebook就會開始處理文章標記，並且非同步匯入文章內容所含的影音素材。

此端點會傳回匯入狀態編號，可用於判斷文章何時成功匯入，或在匯入程序期間是否發生任何錯誤。

在本文中以下概述用於監控文章匯入狀態的端點。

更新現有文章更新現有即時文章的方式和用於建立新即時文章的方式相同。

如果要發表的文章所包含的標準網址和現有即時文章的標準網址相同，則現有文章的標記就會以POST包含的新標記進行更新。

刪除文章若要刪除即時文章，請向以下網址發出DELETE要求：DELETE/{article-id}欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串要求範例DELETEhttps://graph.facebook.com/{article-id}?access_token={access-token}回應範例{ "success":true }取得文章匯入狀態若要取得即時文章的最新匯入狀態，請向以下網址發出GET要求：https://graph.facebook.com/{import-status-id}欄位 名稱 說明 類型 access_token[必要項目]有效的粉絲專頁存取權杖。

字串fields回應中要傳回的其他欄位，以逗號分隔清單表示：errors：在此篇文章中找到的所有錯誤，以陣列表示html_source：此篇文章的完整HTML標記instant_article：產生即時文章物件（如果成功的話）status：指出文章匯入的狀態字串要求範例GEThttps://graph.facebook.com/{import-status-id}?access_token={access-token}要求範例：其他欄位GEThttps://graph.facebook.com/{import-status-id}?fields=errors,html_source,instant_article,status&access_token={access-token}回應範例：成功{ "id":"1234", "status":"SUCCESS" }回應範例：成功傳回其他欄位{ "html_source":"...", "instant_article":{ "id":"1234", "html_source":"...", "canonical_url":"http://..." }, "status":"SUCCESS", "id":"5678" }回應範例：錯誤{ "id":"1234", "status":"IN_PROGRESS", "errors":[ { "level":"ERROR", "message":"CouldnotfindtheCanonicalURLwithinthedocument:SpecifyavalidcanonicalURLusing" } ] }文章轉換即時文章轉換API讓您可以針對如何轉換文章設定一系列規則，將一般的HTML文章轉換為即時文章標記。

標準的Facebook即時文章SDKPHP可用作HTML轉換為即時文章標記的服務。

POST/instant_articles/transformer驗證此端點需要簡單的應用程式權杖，亦即您只需要擁有一款應用程式，並使用金鑰和密鑰取得權杖即可。

下列步驟概述產生有效應用程式權杖的方法，方便您執行內容轉換要求。

GET/oauth/access_token ?client_id={app-id} &client_secret={app-secret} &grant_type=client_credentials您可以在應用程式主控板找到應用程式的「應用程式編號」和「應用程式密鑰」。

如需有關如何產生用戶存取權杖的詳細資訊，請參閱粉絲專頁存取權杖欄位 名稱 說明 類型 access_token[必要項目]有效的應用程式存取權杖。

字串html[若未通知html_url，則為必要項目]欲轉換HTML的實際內容。

字串html_url[若未通知html，則為必要項目]指向欲轉換內容的網址。

字串rules[若未通知rules_url，則為必要項目]JSON（含有已通知HTML的轉換規則）。

請參閱規則編輯器字串rules_url[若未通知rules，則為必要項目]JSON（含有已通知HTML的轉換規則）的參考網址。

請參閱規則編輯器字串log_level選用。

用於通知自轉換程序輸出的訊息記錄層級。

可能的值：OFF、ERROR、INFO和DEBUG。

這將變更回應欄位instant_article_logs上輸出的資訊層級。

OFF表示系統並未輸出任何記錄，而DEBUG最詳細，主要用於疑難排解。

字串要求範例POSThttps://graph.facebook.com/instant-articles/transformer ?access_token={GENERATED_APP_ACCESS_TOKEN} &html_url={THE_URL_OF_PAGE_BEING_CONVERTED} &rules_url={THE_URL_OF_RULES_TO_CONVERT_HTML_INFORMED}回應範例{ "instant_article_markup":"

Title

Someparagraphconverted

...

", "instant_article_warnings":[ "HEREGOESTHEWARNINGMESSAGES" ], "instant_article_logs":[ "[INFO]Transformerinitiatedusingencode[UTF-8]", "[INFO]Transformerfinishedin149mswith(0)warnings" ] }回應欄位 名稱 說明 類型 instant_article_markup此即時文章標記是根據已通知的規則及HTML文章而產生。

字串instant_article_warnings轉換期間產生的警告清單。

若要深入瞭解轉換期間的警告，請參閱說明文件字串清單instant_article_logs轉換期間產生的記錄訊息清單。

此清單最適合用來尋找您的轉換及解決相關問題。

字串清單疑難排解此圖形API端點/instant_articles/transformer是在後台採用Facebook即時文章SDKPHP開放原始碼計畫的服務。

因此，首先可以從瞭解此端點的運作方式著手。

另請注意，您可以將DEBUG值傳送至log_level參數來啟用「偵錯」層級資訊擷取，進而取得更多有關轉換程序及規則處理方式的資訊。

另一個好方法，就是透過開放社交關係圖測試工具試用此端點。

您可以在此嘗試轉換文章，甚至還可嘗試轉換一些透過網路公開發表的文章。