Graph API
Versi Graph API

URL /?id={url}

Mewakili URL yang dibagikan di Postingan atau di Komentar pada Postingan.

Baca dokumen API Pengindeksan Tab Berita kami untuk informasi tambahan.

Membaca

Dapatkan informasi tentang URL yang dibagikan dalam Postingan atau Komentar pada Postingan.

Persyaratan

JenisDeskripsi
Token Akses

Token akses apa pun dapat digunakan untuk membuat permintaan ini.

Fitur

Tidak berlaku.

Tugas Halaman

Tidak berlaku.

Izin

Tidak berlaku.

Batasan

  • Nilai interaksi yang diberikan tidak akurat tetapi mencerminkan interaksi pengguna dengan URL.
  • Anda dibatasi hingga 10 permintaan GET per URL, per aplikasi, per jam.

Parameter

Sertakan parameter string kueri berikut untuk ditambahkan ke permintaan.

ParameterDeskripsi

access_token

Wajib

string

Token akses.

fields

string

Daftar kolom yang dipisahkan koma, yang ingin diminta.

id

string

URL untuk dibagikan.

scopes

string

Daftar cakupan yang dipisahkan koma.

Kolom

Nama Properti Deskripsi Jenis
app_links

Data AppLinks yang terkait dengan URL ini, jika tersedia.

AppLinks

id

URL itu sendiri.

string

engagement

Jumlah berbagai cara orang berinteraksi dengan URL. Perhatikan bahwa nilai interaksi sengaja tidak tepat, tetapi Anda dapat yakin bahwa nilai tersebut secara akurat mencerminkan interaksi pengguna dengan URL.

object

comment_count

Jumlah komentar pada URL.

int

comment_plugin_count

Jumlah komentar pada plugin yang dikumpulkan menggunakan Plugin Komentar di situs Anda.

int

reaction_count

Jumlah tanggapan untuk URL.

int

share_count

Jumlah berapa kali URL dibagikan.

int

og_object

Objek Graf Terbuka yang secara kanonikal terkait dengan URL ini.

OGObject

id

ID objek.

string

description

Deskripsi objek, jika tersedia.

string

title

Judul objek, jika tersedia.

string

type

Jenis objek.

og:type

updated_time

Kapan objek terakhir kali diperbarui.

datetime

Contoh

Untuk mendapatkan informasi tentang URL yang diterbitkan dalam Postingan atau Komentar, kirim permintaan GET ke https://graph.facebook.com dengan parameter id yang diatur ke URL, setiap kolom tentang URL, dan token akses yang diminta dari Pengguna atau Halaman yang menerbitkan Postingan atau Komentar.

Contoh berikut menunjukkan interaksi untuk URL, https://www.facebook.com, yang dibagikan oleh Pengguna yang diwakili oleh token akses Pengguna.

Diformat agar mudah dibaca.
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

Saat berhasil, aplikasi Anda menerima jumlah interaksi berikut untuk URL yang dibagikan:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

Membuat

Anda tidak dapat melakukan operasi ini di endpoint ini.

Memperbarui

Memperbarui URL.

Persyaratan

JenisDeskripsi
Token Akses

Token akses apa pun dapat digunakan untuk membuat permintaan ini.

Fitur

Tidak berlaku.

Tugas Halaman

Tidak berlaku.

Izin

Tidak berlaku.

Contoh

Untuk memperbarui informasi tentang URL yang diterbitkan dalam Postingan atau Komentar, kirim permintaan POST ke https://graph.facebook.com dengan parameter id diatur ke URL, parameter scrape diatur ke true, setiap fields tentang URL, dan token akses yang diminta dari Pengguna atau Halaman yang menerbitkan Postingan atau Komentar.

Contoh berikut memperbarui URL, https://www.facebook.com/my-update, yang dibagikan oleh Pengguna diwakili oleh token akses Pengguna.

Diformat agar mudah dibaca.
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}"

Saat berhasil, aplikasi Anda menerima jumlah interaksi berikut untuk URL yang dibagikan:

{
  "success": true
}

Parameter String Kueri

Sertakan parameter string kueri berikut untuk ditambahkan ke permintaan.

ParameterDeskripsi

access_token

Wajib

string

Token akses.

fields

string

Daftar kolom yang dipisahkan koma, yang ingin diminta.

id

Wajib

string

URL untuk diperbarui. URL harus dienkode agar tidak mengganggu parameter scrape.

scrape

Wajib

boolean

Nilai harus berupa true.

Contoh Permintaan

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

Contoh Tanggapan

{
  "success": true
}

Menghapus

Anda tidak dapat melakukan operasi ini di endpoint ini.