กล่องการแชร์บนฟีด

คุณสามารถเพิ่มกล่องการแชร์บนฟีดลงในแอพของคุณได้ เพื่อให้ผู้คนสามารถเผยแพร่เรื่องราวต่างๆ พร้อมแสดงความคิดเห็นไปยังไทม์ไลน์ของตนได้

การแชร์เรื่องราวผ่านกล่องการแชร์บนฟีดไม่จำเป็นต้องมีการขอสิทธิ์การอนุญาตใดๆ เพิ่มเติม

การผสานการทำงาน

กล่องโต้ตอบนี้สามารถใช้ได้กับ Facebook SDK สำหรับ JavaScript, iOS และ Android และโดยการเปลี่ยนเส้นทางอย่างเต็มรูปแบบไปยัง URL ต่อไปนี้เป็นส่วนย่อยของโค้ดบางส่วนที่สามารถนำมาใช้เพื่อทริกเกอร์กล่องโต้ตอบนี้ได้

JavaScript

หากต้องการทริกเกอร์กล่องการแชร์บนฟีด ให้เรียกใช้ฟังก์ชั่น FB.ui และใช้ค่า feed สำหรับพารามิเตอร์ method

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

อ่านคู่มือเกี่ยวกับกล่องการแชร์สำหรับ iOS ของเราที่จะช่วยให้คุณเผยแพร่ข้อมูล Open Graph ได้อีกด้วย

Android

อ่านเกี่ยวกับกล่องการแชร์สำหรับ Android ของเราที่จะช่วยให้คุณเผยแพร่ข้อมูล Open Graph ได้อีกด้วย

การเปลี่ยนเส้นทาง URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

หมายเหตุ

หากบุคคลได้ตั้งค่า "ใครสามารถโพสต์บนไทม์ไลน์ของคุณได้บ้าง" ไว้เป็น "เฉพาะฉัน" และบุคคลอื่นพยายามที่จะโพสต์ลงบนไทม์ไลน์ของบุคคลแรกโดยใช้กล่องการแชร์บนฟีด ระบบจะแสดงข้อผิดพลาด "ไม่สามารถโพสต์ได้" ขึ้นมา

พารามิเตอร์

หมายเหตุ: หากแอพของคุณแชร์ลิงก์ไปยังร้านค้าใน iTunes หรือ Google Play หรือไปยังโปรไฟล์หรือเพจ Facebook เราจะไม่โพสต์รูปภาพหรือคำอธิบายใดๆ ที่คุณระบุไว้ในการแชร์ด้วยพารามิเตอร์ด้านล่างนี้ แต่เราจะโพสต์ข้อมูลแอพบางส่วนที่เราดึงมาจากจากร้านค้าในแอพหรือหน้า Facebook โดยตรงด้วย Webcrawler แทน ซึ่งอาจไม่มีรูปภาพรวมอยู่ด้วย หากต้องการดูตัวอย่างการแชร์ลิงก์ไปยัง iTunes หรือ Google Play ให้ป้อน URL ของคุณในตัวแก้ไขจุดบกพร่องการแชร์

พารามิเตอร์ คำอธิบาย

app_id

ตัวระบุที่ไม่ซ้ำกันของแอพของคุณ ต้องระบุ

redirect_uri

URL ที่จะเปลี่ยนเส้นทางไปหลังจากผู้ใช้คลิกปุ่มบนกล่องโต้ตอบ ต้องระบุเมื่อใช้การเปลี่ยนเส้นทาง URL

display

กำหนดการแสดงผลกล่องโต้ตอบ

  • หากคุณเลือกใช้กล่องโต้ตอบการเปลี่ยนเส้นทาง URL ระบบจะแสดงผลแบบเต็มหน้าภายใน Facebook.com การแสดงผลประเภทนี้เรียกว่า page
  • หากคุณใช้ Facebook SDK สำหรับ iOS หรือ Android เพื่อเรียกใช้กล่องโต้ตอบ ระบบจะระบุการแสดงผลโดยอัตโนมัติ และจะเลือกการแสดงผลประเภทที่เหมาะสมสำหรับอุปกรณ์
  • หากคุณใช้ Facebook SDK for Javascript การแสดงผลเริ่มต้นจะเป็นประเภท iframe แบบโมดัลสำหรับผู้ใช้ที่เข้าสู่ระบบแอพของคุณหรือเป็น async เมื่อใช้ในเกมบน Facebook.com และแสดงเป็นหน้าต่าง popup สำหรับคนอื่นๆ คุณยังสามารถบังคับให้แสดงเป็นประเภท popup หรือ page เมื่อใช้ Facebook SDK for JavaScript ได้อีกด้วย หากจำเป็น
  • แอพเว็บบนมือถือจะแสดงผลเริ่มต้นเป็นประเภท touch เสมอ

from

ID ของบุคคลที่โพสต์ข้อความ หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็นบุคคลปัจจุบัน แต่หากระบุ จะต้องเป็น ID ของบุคคลหรือของเพจที่บุคคลดังกล่าวดูแล

to

ID ของโปรไฟล์ที่จะเป็นปลายทางของการเผยแพร่สตอรี่นี้ หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็นค่าของ from ID จะต้องเป็นเพื่อนที่ใช้แอพของคุณด้วย

link

ลิงก์ที่แนบกับโพสต์นี้

source

URL ของไฟล์สื่อ (SWF หรือ MP3) ที่แนบมากับโพสต์นี้ หากเป็นไฟล์ SWF คุณจะต้องระบุ picture เพื่อให้วิดีโอมีภาพขนาดย่อ

ref

อาร์กิวเมนต์นี้เป็นรายการที่คั่นด้วยเครื่องหมายจุลภาค ซึ่งประกอบด้วยรายการที่แตกต่างกันไม่เกิน 5 รายการ โดยแต่ละรายการประกอบไปด้วยอักขระที่มาจากชุดอักขระ “0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_” ที่มีความยาวอย่างน้อย 1 อักขระ แต่ไม่เกิน 15 อักขระ แต่ละหมวดหมู่จะมีการนำมาใช้ในข้อมูลเชิงลึกของ Facebook เพื่อช่วยคุณในการวัดผลประสิทธิภาพของโพสต์ประเภทต่างๆ

พารามิเตอร์ที่เลิกใช้แล้ว

พารามิเตอร์ คำอธิบาย

post_id

ID ของสตอรี่ที่โพสต์ หากบุคคลนั้นเลือกที่จะเผยแพร่ไปยังไทม์ไลน์ของตน

properties

อ็อบเจ็กต์ JSON ของคู่คีย์/ค่าที่จะปรากฏในสิ่งที่แนบมากับสตรีมใต้คำอธิบาย โดยแต่ละคุณสมบัติจะอยู่ในบรรทัดของตัวเอง คีย์จะต้องเป็นสตริง ส่วนค่าสามารถเป็นได้ทั้งสตริงหรืออ็อบเจ็กต์ JSON ที่มีคีย์ text และ href

actions

อาร์เรย์ JSON ที่มีอ็อบเจ็กต์เดียวที่อธิบายลิงก์การดำเนินการซึ่งจะปรากฏถัดจากลิงก์ "แสดงความคิดเห็น" และ "ถูกใจ" ที่อยู่ใต้โพสต์ อ็อบเจ็กต์ที่มีอยู่จะต้องมีคีย์ name และ link

picture

URL ของรูปภาพที่แนบกับโพสต์นี้ รูปภาพต้องมีขนาดอย่างน้อย 200 x 200 พิกเซล โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับขนาดจากเอกสารประกอบเกี่ยวกับหลักปฏิบัติที่ดีที่สุดในการแชร์

name

ชื่อไฟล์แนบของลิงก์

caption

คำบรรยายของลิงก์ (แสดงใต้ชื่อลิงก์) หากไม่ได้ระบุไว้ ระบบจะกรอก URL ของลิงก์ลงในช่องนี้โดยอัตโนมัติ

description

คำบรรยายลิงก์ (แสดงใต้คำอธิบายลิงก์) หากไม่ได้ระบุไว้ ระบบจะกรอกข้อมูลที่ดึงมาจากลิงก์ดังกล่าวลงในช่องนี้โดยอัตโนมัติ ซึ่งมักจะเป็นชื่อเพจ

thumbnail

ไฟล์รูปภาพในเครื่องที่อัพโหลดไว้ โดยมีนามสกุลไฟล์เป็น .jpg.jpeg.gif หรือ .png