> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Facebook Page API > 使用 Facebook API 發布內容的選項 export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; 如果你在連結 Facebook 時遇到問題，請參閱[疑難排解 指南](/help-center/technical-support/facebook_posting_issues)。 ## 發布到 Facebook 使用 Facebook API 發布內容需要連結一個 Facebook 粉絲專頁。Facebook 不允許連結個人帳號。 發布含連結與圖片到 Facebook 粉絲專頁的基本貼文 JSON 範例： ```json Facebook Post with Image theme={"system"} { "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["facebook"] } ``` Facebook 的 API 不支援在單一貼文中同時包含圖片與影片。你 可以放多張圖片或一部影片，但不能兩者同時。 ## 輪播圖片 透過 Ayrshare API 的 `carousel` body 參數發布 Facebook 輪播圖片。 ```json Facebook Carousel Post theme={"system"} { "faceBookOptions": { "carousel": { // The URL of the "See More At" button - required "link": "URL of See More At...", "items": [ // 2 min, 10 max elements in the array { "name": "Image name", // optional "link": "URL when image clicked", // required "picture": "URL of image" // required }, { "name": "Image name", "link": "URL when image clicked", "picture": "URL of image" } ] } } } ``` **注意：** 不要與 `carousel` 同時使用 `media_urls`。若使用 `media_urls`，`carousels` 會被忽略。 更多資訊請參閱我們的 [Facebook 輪播指南](https://www.ayrshare.com/blog/post-a-series-of-facebook-images-as-a-carousel/)。 ## Facebook Reels 透過以下 `facebookOptions`，你可以將影片發布到 Facebook Reels。 Meta 對每個已連結的 Facebook 粉絲專頁在任何 24 小時內設有 30 則 Reels 的上限，以防止 垃圾內容並維持平台品質。此為滾動限制，計算的是最近的 24 小時，而非日曆日。 ```json Facebook Reels Post theme={"system"} { "post": "The description of the video", "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"], "faceBookOptions": { "reels": true, "title": "Super title for the Reel", // optional "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional } } ``` 請參閱 [Reels API 影片需求](/media-guidelines/facebook_pages#reels)，或 [使用 Facebook Reels API 的範例](https://www.ayrshare.com/blog/facebook-reels-api-how-to-post-fb-reels-using-a-social-media-api/)。 Meta 有時對於某些帳號會處理 Facebook Reels 時發生問題。即使回傳錯誤回應，Reel 仍可能已發布成功。 如果你在 Facebook Reels 上遇到錯誤，建議先檢查該 Reel 的狀態。若貼文 *未被* 發布，你可以嘗試[再發布一次](/apis/post/retry-post)，這通常會成功。 你可以使用 `verifyReelsUrl` 欄位中的 URL 檢查狀態。請務必使用與原本貼文相同的 Profile Key。請等到 `verifyReelsIn`（10 分鐘後）的時間再檢查 Reel 狀態。若回傳 HTTP 錯誤代碼 `400`，代表發布失敗，你可以再嘗試一次。 ```json Facebook Reels Post Error theme={"system"} { "action": "post", "status": "error", "code": 108, "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ", "detailsData": { "id": "104619420979033_36930641143", "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook", "verifyReelsIn": "2024-01-26T00:07:05.170Z", "postUrl": "https://www.facebook.com/1046194209_36930641143", "reels": true }, "retryAvailable": true, "platform": "facebook" } ``` ## Facebook Stories 以照片或影片的形式將 Facebook Stories 發布到 Facebook 粉絲專頁。 ```json Facebook Stories Post theme={"system"} { "post": "", // Ignored by stories "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"], "faceBookOptions": { "stories": true } } ``` 請參閱 [Stories API 圖片與影片需求](/media-guidelines/facebook_pages#stories)。 ## 媒體說明 為發布的每張 Facebook 圖片設定媒體說明。 接受字串說明文字的陣列。每個陣列元素必須對應一個媒體 URL。例如 \["This is my best pic", "😃 here is the next one"] 分別對應 `mediaUrls` 中的第 1 個與第 2 個 URL。 ```json Facebook Media Captions theme={"system"} { "faceBookOptions": { "mediaCaptions": ["This is my best pic", "😃 here is the next one"] } } ``` ## 地點標註 Facebook 地點標籤透過 `locationId` 指定，其為 Facebook Page ID 或 Facebook Page 名稱。例如，[Guggenheim Museum](https://www.facebook.com/guggenheimmuseum) 的 Facebook page ID 是 `7640348500`，或 Facebook page 名稱 `"@guggenheimmuseum"`。粉絲專頁必須關聯有實體地點。 ```json Facebook Location Tagging theme={"system"} // Using the Facebook Page Id - must be associated with a location { "faceBookOptions": { "locationId": 7640348500 // Guggenheim Museum Page Id } } ``` 你可以使用 [brand 端點](/apis/listen/search/fb-page-search) 查詢 `locationId`（Page ID）。請注意，該粉絲專頁必須有列出地點，否則 locationId 會回傳錯誤。 不支援套用於純文字貼文、圖片、Reels 與 Stories。Meta 不支援對影片進行地點標註。 ## 受眾鎖定 在 Facebook 上建立 Page 貼文時，可以使用兩種鎖定方式將可見範圍限制在特定受眾： 1. Facebook Targeting：可依年齡、性別、地區與感情狀態等條件定義貼文的受眾。透過設定這些參數，你可以確保只有符合條件的人能看到你的貼文。 2. Facebook Feed Targeting：可進一步微調貼文在目標受眾動態消息中的可見度。 你可以單獨使用其中一種鎖定選項，也可以合併使用。 ### Targeting Facebook targeting 會將發布內容的[受眾限制](https://www.facebook.com/help/352402648173466)於特定人口統計族群。不在這些族群中的人將無法看到該內容。此設定不會覆蓋粉絲專頁層級可能已設定的人口統計限制。 `targeting` 可用的人口統計欄位： ```json Facebook Targeting theme={"system"} { "faceBookOptions": { "targeting": { "ageMin": 18, "countries": ["DE", "BR"] } } ``` ### Feed Targeting Facebook feed targeting 群組中的使用者較有可能看到此貼文，其他人較不容易看到，但仍可能會看到。如果你想確保限制生效，請使用上方的 targeting。 `feedTargeting` 可用的人口統計欄位： ```json Facebook Feed Targeting theme={"system"} { "feedTargeting": { "ageMax": 30, "ageMin": 26, "countries": ["DE", "BR"], "genders": [1, 2], "relationshipStatuses": [1, 2] } } ``` ## 替代文字 為 Facebook 圖片或影片加上替代文字（alt text）。Facebook alt text 是一項無障礙功能，可提供額外的使用者資訊，並協助螢幕閱讀器讀取內容。 請在 `faceBookOptions` 物件中使用 `altText`。 ```json Facebook Alt Text theme={"system"} { "faceBookOptions": { // Array of Alt Texts "altText": ["This is my best pic", "😃 here is the next one"] } } ``` 每個 alt text 必須對應到 `mediaUrls` 陣列中的一張圖片或一部影片，並依序套用到每張圖片上。 ## 影片縮圖 為 Facebook 影片設定縮圖（封面圖片）。請傳送 PNG 或 JPG 檔案的遠端 URL，尺寸須與影片相同且小於 10 MB。URL 應以 .png 或 .jpg 結尾。 ```json Example Facebook Video Thumbnail theme={"system"} { "faceBookOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` ## 影片標題 透過 `title` 參數為 Facebook 影片加上標題。 ```json Facebook Video Title theme={"system"} { "faceBookOptions": { "title": "The best video ever!" } } ``` ## 動態 GIF 發布 Facebook 動態 GIF 時，`mediaUrls` 陣列中只允許一個 URL。 如果媒體 URL 不是以 ".gif" 或 ".GIF" 結尾，請將 `isVideo` 欄位設為 `true`。 ```json Facebook Animated GIF theme={"system"} { "randomPost": true, "platforms": ["facebook"], // Set to true if the GIF URL does not end in .gif or .GIF "isVideo": false, // Only one URL is allowed in the array "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"] } ``` ## Facebook 粉絲專頁提及 你可以透過在貼文文字中加入 Facebook 粉絲專頁名稱或 Page ID 來提及另一個 Facebook 粉絲專頁（也稱為 Facebook 提及或 Facebook 標註）。 Facebook 不允許提及或標註個人檔案或社團。 用以下 @提及 格式加入提及： `@page-name` 或 `@[page-id]` ### 使用粉絲專頁名稱提及 使用粉絲專頁名稱的貼文文字範例。你可以從 Facebook URL 找到粉絲專頁名稱，例如 [https://www.facebook.com/Ayrshare](https://www.facebook.com/Ayrshare) ```json Facebook Page Mention with Page Name theme={"system"} { "post": "This is the best social media api by @Ayrshare" } ``` Ayrshare 會盡力依名稱尋找對應的粉絲專頁，但有時可能會找不到相符的專頁。使用 Page ID 是更可靠的方法。 ### 使用 Page ID 提及 使用 Page ID 的貼文文字範例，注意 \[] 的使用。如何取得 Page ID 請參閱下方說明。 ```json Facebook Page Mention with Page ID theme={"system"} { "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID } ``` Facebook Page ID 會解析到對應的粉絲專頁，並 ***通知被提及的粉絲專頁***。 使用粉絲專頁提及請務必謹慎，只提及與你有關聯的粉絲專頁。切勿進行垃圾騷擾。 當你提及某個粉絲專頁時，**該粉絲專頁的擁有者會透過通知與電子郵件收到提醒**。若有多個粉絲專頁對你的提及提出檢舉，Facebook 可能會停權你的帳號。原則上，你應只標註與你有既有合作關係的粉絲專頁。 被提及的 Facebook 粉絲專頁**必須允許**其他粉絲專頁提及/標註其專頁。可在該粉絲專頁的一般設定中「Others Tag this Page」啟用提及功能。 請詳閱關於提及功能的[重要規則](/testing/post-verification#mentions)。 ### 找出 Facebook Page ID #### Brand 端點 你可以使用 [Brand 端點](/apis/brand/overview) 查詢 Facebook 使用者或 Facebook 粉絲專頁。 #### 在 Facebook.com 1. 從 Facebook 動態消息，點擊左側選單中的 **Pages**。 2. 點擊你的粉絲專頁名稱進入你的粉絲專頁。 3. 點擊粉絲專頁頂端的 **About**。若看不到，請點擊 **More**▼。 4. 向下捲動，在 **MORE INFO** 下方找到你的 **Page ID**。 若要查詢你不擁有的粉絲專頁 ID： `https://www.facebook.com/pages/ayrshare/123466789203`，則 Page ID 為結尾的數字，例如 **123466789203**。 你可以透過前往 `https://facebook.com/page-id` 來測試 Page ID 是否正確，該網址應能解析到對應的粉絲專頁。 你也可以嘗試 Ayrshare 未提供支援的第三方 Facebook 粉絲專頁查詢工具，例如：[https://lookup-id.com/](https://lookup-id.com/) 如果以上方法都行不通，你可以在瀏覽器中開啟該 Facebook 粉絲專頁並檢視原始碼。在 Chrome 中，右鍵選擇「View Source」，然後搜尋 `owning_profile_id` 或 `profile_id` 來找到 Page ID。 請詳閱關於提及功能的[重要規則](/testing/post-verification#mentions)。 ### 啟用粉絲專頁提及 該粉絲專頁必須允許在貼文與留言中被提及與標註。此功能預設為啟用，但你可以登入 facebook.com 並切換至你的粉絲專頁進行確認。 1. 以粉絲專頁身分檢視時，點擊右上角的粉絲專頁**個人資料圖片**。 2. 點擊 **Settings & Privacy** -> **Settings**。 3. 在 Settings 選單中，點擊 **Privacy**。 4. 點擊 **Page and Tagging**。 5. 向下捲動至 **Reviewing**。 6. 切換設定以允許標註與提及。 ## Meta Business Suite ### 草稿貼文 建立 Facebook 草稿貼文，草稿會顯示在 [Meta Business Suite Draft](https://business.facebook.com/latest/posts/draft_posts) 分頁。Facebook 草稿貼文是你已開始撰寫但尚未發布的貼文。你可以先儲存草稿之後再回來編輯，或排程於未來的時間發布。 在 `faceBookOptions` 中加入 `draft` 參數，即可將貼文送出為草稿。適用於純文字、圖片、影片與 Reels 貼文。 ```json Facebook Draft Post theme={"system"} { "faceBookOptions": { "draft": true } } ``` ### 排程發布時間 為 Facebook 貼文設定排程發布時間，該貼文會顯示在 [Meta Business Suite Scheduled Posts](https://business.facebook.com/latest/posts/scheduled_posts) 分頁。Facebook 排程貼文是指你已建立並排程在未來日期發布，並在 Meta Business Suite 中管理的貼文。這適合用於提前規劃你的社群貼文，或在你已知受眾最活躍的時段發布貼文。 適用於純文字、圖片、影片與 Reels 貼文。 發布時間必須比目前時間至少晚 10 分鐘，且不能超過目前日期的 29 天後。 除非你需要在 Meta Business Suite 中管理 Facebook 貼文，否則建議使用標準的 [貼文排程日期](/apis/post/overview#schedule-posts)。 在 `faceBookOptions` 中加入 `scheduledPublishDate` 參數以排程貼文時間。 ```json Facebook Scheduled Post theme={"system"} { "faceBookOptions": { "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC } } ``` ## 連結預覽 Facebook 貼文會自動為貼文內容中的連結建立連結預覽。 但若你想指定不同的連結，或強制顯示連結預覽，可使用 `link` 參數指定連結的 URL。 ```json Facebook Link Preview theme={"system"} { "faceBookOptions": { "link": "https://www.ayrshare.com/instagram-hashtag-guide/" } } ``` 如果貼文請求中包含 `mediaUrls` 欄位，會顯示媒體而非連結預覽。 ## Facebook Ads Facebook Ads 是將你的貼文推廣給更廣泛受眾的方法。 ## 字元限制 更多資訊請參閱 [Facebook 字元限制](/help-center/technical-support/character_limits#facebook-character-limits)。 ## 補充資訊 ### 如何在 Facebook 貼文中加入換行或 rich text？ Facebook 貼文中的換行可以使用特殊的[換行字元](/apis/post/overview#line-breaks)加入。 Rich text（例如粗體或斜體）可以透過幾個 [HTML 元素](/apis/post/overview#rich-text-posts) 加到 Facebook 貼文中。 ### 為什麼我在貼文上看到「Published by Ayrshare」？ 別擔心，這只會顯示在管理員檢視畫面中。更多資訊請參閱[疑難排解指南](/help-center/technical-support/facebook_shows_published_by_ayrshare)。