مستخدم IG

يمثل حساب Instagram للأعمال أو حساب منشئ محتوى Instagram.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /{ig-user-id}

الحصول على حقول وعناصر ربط في حساب Instagram للأعمال أو حساب منشئ محتوى Instagram.

المتطلبات

النوع	الوصف
رموز الوصول	المستخدم.
أدوار النشاط التجاري	إذا كنت تطلب الحقل `shopping_product_tag_eligibility`للإشارة إلى المنتجات، فيجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يمتلك متجر Instagram التابع لمستخدم IG.
متجر Instagram	إذا كنت تطلب الحقل `shopping_product_tag_eligibility`للإشارة إلى المنتجات، فيجب أن يمتلك مستخدم IG متجر Instagram معتمدًا يتضمن كتالوج منتجات يحتوي على المنتجات.
الأذونات	`instagram_basic` `pages_read_engagement` `pages_show_list` إذا تم منح مستخدم التطبيق دورًا في الصفحة عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي: `ads_management` `business_management` إذا كنت تطلب الحقل `shopping_product_tag_eligibility`الإشارة إلى المنتجات، فستحتاج أيضًا إلى ما يلي: `catalog_management` `instagram_shopping_tag_products`

بنية الطلب

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

معلمات المسار

العنصر النائب	القيمة
`{api-version}`	إصدار API.
`{ig-user-id}`	مطلوب. يمثل معرف مستخدم IG.

معلمات سلسلة الاستعلام

المفتاح	العنصر النائب	القيمة
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم لمستخدم التطبيق.
`fields`	`{fields}`	يمثل قائمة مفصولة بفاصلة تتضمن حقول مستخدم IG التي تريد إرجاعها لكل مستخدم IG في مجموعة النتائج.

الحقول

يمكن إرجاع الحقول العامة عن طريق عنصر ربط باستخدام توسيع الحقل.

اسم الحقل	الوصف
`biography` عام	يمثل نص السيرة الذاتي في الملف الشخصي.
`id` عام	يمثل معرف المستخدم على مستوى التطبيق.
`ig_id`	يمثل معرف مستخدم Instagram. كان يُستخدم في Instagram API القديمة، وتم إيقاف استخدامه حاليًا. استخدم `id` بدلاً من ذلك.
`followers_count` عام	يمثل إجمالي عدد مستخدمي Instagram الذين يتابعون المستخدم.
`follows_count`	يمثل إجمالي عدد مستخدمي Instagram الذين يتابعهم المستخدم.
`media_count` عام	يمثل إجمالي عدد وسائط IG المنشورة لدى المستخدم.
`name`	يمثل اسم الملف الشخصي.
`profile_picture_url`	يمثل عنوان URL لصورة الملف الشخصي.
`shopping_product_tag_eligibility`	يتم إرجاع `true` إذا قام مستخدم التطبيق بإعداد متجر Instagram وبالتالي يُعد مؤهلاً للإشارة إلى المنتج، وبخلاف ذلك يتم إرجاع `false`.
`username` عام	يمثل اسم المستخدم في الملف الشخصي.
`website` عام	عنوان URL موقع ويب الملف الشخصي الفردي.

عناصر الربط

عنصر الربط	الوصف
`business_discovery`	يمكن الحصول على البيانات حول مستخدمي IG الآخرين في حساب Instagram للأعمال أو منشئ محتوى Instagram.
`content_publishing_limit`	يمثل الاستخدام الحالي لنشر المحتوى لدى مستخدم IG.
`insights`	يمكن أن تمثل أدوات قياس التفاعل على مواقع التواصل الاجتماعي لدى مستخدم IG.
`live_media`	يمثل مجموعة من وسائط IG لفيديو البث المباشر حول مستخدم IG.
`media`	يمثل مجموعة من وسائط IG حول مستخدم IG.
`media_publish`	يمكنك نشر حاوية IG لدى مستخدم IG لحساب Instagram للأعمال.
`mentions`	أنشئ تعليق IG في وسائط IG التي تتضمن تعليقًا أو شرحًا توضيحيًا تم في @ذكر مستخدم IG بواسطة مستخدم آخر على Instagram.
`mentioned_comment`	يمكن الحصول على بيانات حول تعليق IG الذي تم فيه @ذكر مستخدم IG بواسطة مستخدم Instagram آخر.
`mentioned_media`	يمكن الحصول على بيانات حول وسائط IG التي تم @ذكر مستخدم IG في الشرح التوضيحي التابع لها بواسطة مستخدم Instagram آخر.
`recently_searched_hashtags`	يمكنك الحصول على علامات الهاشتاج في IG التي بحث عنها مستخدم IG خلال آخر 7 أيام.
`stories`	يمثل مجموعة من كائنات وسائط IG للقصص تخص مستخدم IG.
`tags`	تمثل مجموعة من وسائط IG التي تمت الإشارة فيها إلى مستخدم IG بواسطة مستخدم Instagram آخر.

الاستجابة

كائن بتنسيق لغة JSON يتضمن الحقول وعناصر الربط الافتراضية والمطلوبة.

{
  "{field}":"{value}",
  ...
}

مثال على cURL

الطلب

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

الاستجابة

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.