Graph API
Versi Graph API

Tanggapan Objek

Referensi ini menggambarkan edge /reactions yang umum untuk beberapa node Graph API. Struktur dan operasinya sama untuk setiap node. Objek berikut memiliki edge /reactions:

Membaca

Mendapatkan tanggapan atas objek.

Lihat Insight untuk informasi selengkapnya tentang tanggapan pada Halaman dan Postingan.

Pengalaman Halaman Baru

Endpoint ini didukung untuk Pengalaman Halaman Baru.

Persyaratan

Aplikasi Pemasaran

  • ads_management
  • pages_read_engagement
  • pages_show_list

Aplikasi Pengelola Halaman

  • pages_show_list

Contoh Permintaan

Contoh berikut adalah permintaan GET yang dibuat oleh Pengguna yang telah menanggapi objeknya sendiri.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id/reactions?access_token=your-user-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id/reactions",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id/reactions"
           parameters:nil
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id/reactions',
  'GET',
  {},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-id/reactions',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Tanggapan JSON

{
  "data": [
    {
      "id": "your-user-id",
      "name": "Your Name",
      "type": "HAHA"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
      "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
    }
  }
}

Jika Pengguna atau Halaman tidak menanggapi objek yang di-kueri, data akan kosong.

Contoh berikut adalah permintaan GET untuk total tanggapan atas suatu objek.

curl -i -X GET \
 "https://graph.facebook.com/your-post-id
   ?fields=reactions.summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-post-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-post-id"
           parameters:@{ @"fields": @"reactions.summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-post-id',
  'GET',
  {"fields":"reactions.summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-post-id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Tanggapan JSON jika Pengguna atau Halaman menanggapi objeknya sendiri.

{
  "reactions": {
    "data": [
      {
        "id": "your-user-id",
        "name": "Your Name",
        "type": "HAHA"
      }
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
        "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
      }
    },
    "summary": {
      "total_count": 28
    }
  },
  "id": "your-post-id"
}

Tanggapan JSON jika Pengguna atau Halaman belum menanggapi objeknya sendiri.

{
  "reactions": {
    "data": [
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUk5YbXFFbG8yVWVOa2w0ZAGhmSUNKMkZAZAOXZARbzJOMHM0TUFtZAnhJbWdPdkF4OURUTHJrQjFqQ2RQZAVN1UGxSVU5FWURENnE4OUFPeXFreU1jV09pdFJR",
        "after": "QVFIUkpsWVRkcVl6SlhsdWlrcGdudl8xVEhwVEJ5ZA3FXdG90bTRxam13NmJDUGpQVnB5ZA29lMG9FVmFaeU1BLW1hc2oZD"
      }
    },
    "summary": {
      "total_count": 28
    }
  },
  "id": "your-post-id"
}

Pengguna atau Halaman hanya dapat meng-kueri tanggapannya sendiri. Tanggapan Pengguna atau Halaman lain tidak tersedia karena alasan privasi.

Jumlah tanggapan "suka" mencakup tanggapan "suka" dan "peduli".

Parameter

NamaDeskripsi

type

enum {TIDAK ADA, SUKA, SUPER, WOW, HAHA, MENYESAL, MARAH}

Jenis tanggapan Halaman atau Pengguna menandai suatu objek

Kolom

Membaca dari edge ini akan mengembalikan hasil berformat JSON

{
    "data": [],
    "paging": {},
    "summary": {}
}

data

Profil Halaman atau Pengguna yang menjalankan kueri, jika objek yang di-kueri telah ditanggapi Halaman atau Pengguna, dan daftar jenis tanggapan:

KolomDeskripsi

type

enum {TIDAK ADA, SUKA, SUPER, WOW, HAHA, MENYESAL, MARAH}

Jenis tanggapan Halaman atau Pengguna menandai suatu objek.

Untuk tanggapan pada Postingan, edge ini tidak mengembalikan Profil kecuali untuk pengguna saat ini, jika dibaca dengan token akses pengguna.

Melihat jumlah tanggapan individu

curl -i -X GET \
 "https://graph.facebook.com/your-object-id
   ?fields=reactions.type(LOVE).limit(0).summary(total_count)
   &access_token=your-access-token"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/your-object-id",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "reactions.type(LOVE).limit(0).summary(total_count)");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/your-object-id"
           parameters:@{ @"fields": @"reactions.type(LOVE).limit(0).summary(total_count)",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/your-object-id',
  'GET',
  {"fields":"reactions.type(LOVE).limit(0).summary(total_count)"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/your-object-id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Contoh JSON Dikembalikan

{
  "reactions": {
    "data": [
    ],
    "summary": {
      "total_count": 3498
    }
  },
  "id": "your-object-id"
}

paging

Untuk detail selengkapnya tentang paginasi, lihat dokumentasi paginasi Graph API. Menambahkan limit(0) ke reactions akan menghapus paging dari output.

summary

Agregat informasi tentang edge, seperti jumlah. Menentukan kolom yang akan diambil di param ringkasan (seperti summary=total_count).

KolomDeskripsi

total_count

unsigned int32

Total jumlah tanggapan

viewer_reaction

enum {TIDAK ADA, SUKA, SUPER, WOW, HAHA, MENYESAL, MARAH}

Jenis tanggapan Halaman atau Pengguna menandai suatu objek.

Kode Kesalahan

KesalahanDeskripsi

100

Parameter tidak valid

Membuat

Operasi ini tidak didukung.

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.