URL /?id={url}
Biểu thị một URL được chia sẻ trong Bài viết hoặc trong Bình luận về Bài viết.
Hãy tham khảo tài liệu của chúng tôi về API Lập chỉ mục tab Tin tức để biết thêm thông tin.
Đọc
Lấy thông tin về một URL được chia sẻ trong Bài viết hoặc Bình luận về Bài viết.
Yêu cầu
| Loại | Mô tả |
|---|---|
| Mã truy cập | Mọi mã truy cập có thể dùng để gửi yêu cầu này. |
| Tính năng | Không áp dụng. |
| Tác vụ trên Trang | Không áp dụng. |
| Quyền | Không áp dụng. |
Các giới hạn
- Giá trị tương tác được trả về không chính xác, nhưng thể hiện mức độ tương tác của người dùng với URL.
- Mỗi giờ, bạn chỉ được gửi 10 yêu cầu GET trên mỗi URL và ứng dụng.
Thông số
Thêm các thông số chuỗi truy vấn sau đây vào yêu cầu.
| Thông số | Mô tả |
|---|---|
Bắt buộc chuỗi | |
chuỗi | Danh sách các trường mà bạn muốn yêu cầu, được phân tách bằng dấu phẩy. |
chuỗi | URL cần chia sẻ. |
chuỗi | Danh sách các phạm vi được phân tách bằng dấu phẩy. |
Trường
| Tên thuộc tính | Mô tả | Loại |
|---|---|---|
app_links | Dữ liệu Liên kết ứng dụng được liên kết với URL này, nếu có. | AppLinks |
| Chính URL. |
|
| Số cách khác nhau mà mọi người tương tác với URL Lưu ý rằng giá trị lượt tương tác không chính xác là theo chủ đích. Tuy nhiên, bạn có thể tin tưởng rằng giá trị đó phản ánh chính xác lượt tương tác của người dùng với URL. |
|
| Đối tượng trong Open Graph liên kết chính thức với URL này. |
|
Ví dụ
Để lấy thông tin về một URL được đăng trong Bài viết/Bình luận, hãy gửi yêu cầu GET đến https://graph.facebook.com kèm theo thông số id được đặt là URL này, mọi trường về URL này và mã truy cập mà Người dùng hoặc Trang đăng Bài viết/Bình luận nêu trên yêu cầu.
Dưới đây là ví dụ minh họa mức độ tương tác cho URL (https://www.facebook.com) mà Người dùng (được biểu thị bằng mã truy cập dành cho Người dùng) chia sẻ.
Được định dạng để dễ đọc.curl -i -X GET \
"https://graph.facebook.com/{latest-graph-api-version}/
?id=https://www.facebook.com
&fields=engagement
&access_token={user-access-token}"Nếu thành công, ứng dụng của bạn sẽ nhận được số lượt tương tác dưới đây cho URL được chia sẻ:
{
"engagement": {
"reaction_count": 514919172,
"comment_count": 68687082,
"share_count": 975739682,
"comment_plugin_count": 1641
},
"id": "https://www.facebook.com"
}Tạo
Bạn không thể thực hiện thao tác đó trên điểm cuối này.
Cập nhật
Cập nhật URL.
Yêu cầu
| Loại | Mô tả |
|---|---|
| Mã truy cập | Mọi mã truy cập có thể dùng để gửi yêu cầu này. |
| Tính năng | Không áp dụng. |
| Tác vụ trên Trang | Không áp dụng. |
| Quyền | Không áp dụng. |
Ví dụ
Để cập nhật thông tin về một URL được đăng trong Bài viết/Bình luận, hãy gửi yêu cầu POST đến https://graph.facebook.com kèm theo thông số id được đặt là URL này, thông số scrape được đặt là true, mọi fields về URL này và mã truy cập mà Người dùng hoặc Trang đăng Bài viết/Bình luận nêu trên yêu cầu.
Dưới đây là ví dụ cập nhật URL (https://www.facebook.com/my-update) mà Người dùng (được biểu thị bằng mã truy cập dành cho Người dùng) chia sẻ.
Được định dạng để dễ đọc.curl -i -X POST \
"https://graph.facebook.com/{latest-graph-api-version}/
?id=https://www.facebook.com/my-update
&scrape=true
&access_token={user-access-token}"Nếu thành công, ứng dụng của bạn sẽ nhận được số lượt tương tác dưới đây cho URL được chia sẻ:
{
"success": true
} Thông số chuỗi truy vấn
Thêm các thông số chuỗi truy vấn sau đây vào yêu cầu.
| Thông số | Mô tả |
|---|---|
Bắt buộc chuỗi | |
chuỗi | Danh sách các trường mà bạn muốn yêu cầu, được phân tách bằng dấu phẩy. |
Bắt buộc chuỗi | URL cần cập nhật. Bạn phải mã hóa URL này để không làm ảnh hưởng đến thông số |
Bắt buộc boolean | Giá trị phải là |
Yêu cầu mẫu
POST /{version}/?id={url}&scrape=true
Host: graph.facebook.comPhản hồi mẫu
{
"success": true
}Xóa
Bạn không thể thực hiện thao tác đó trên điểm cuối này.