مستخدم IG

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

نستخدم خلال وثائقنا المصطلحين "مستخدم Instagram" و"حساب Instagram" بالتبادل. ويمثل كلاهما الحساب الاحترافي على Instagram لدى مستخدم التطبيق.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

الإنشاء

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

القراءة

GET /<IG_USER_ID>

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

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

بنية الطلب

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

العنصر النائب	القيمة
`<API_VERSION>`	إصدار واجهة API.
`<IG_USER_ID>`	مطلوب. يمثل معرف مستخدم IG.

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

المفتاح	العنصر النائب	القيمة
`access_token`	`<ACCESS_TOKEN>`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`fields`	`<LIST_OF_FIELDS>`	قائمة مفصولة بفاصلة تتضمن حقول مستخدم IG التي تريد إرجاعها لكل مستخدم IG في مجموعة النتائج.

الحقول

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

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

عناصر الربط

عنصر الربط	الوصف
`agencies`	قائمة بالأنشطة التجارية التي يمكنها الإعلان لهذا الحساب الاحترافي على Instagram.
`authorized_adaccounts`	الحسابات الإعلانية التي يمكنها الإعلان لهذا الحساب الاحترافي على Instagram.
`business_discovery`	يمكن الحصول على البيانات حول مستخدمي IG الآخرين في حساب Instagram للأعمال أو منشئ محتوى Instagram.
`connected_threads_user`	يمثل حساب Threads المرتبط بحساب Instagram.
`content_publishing_limit`	يمثل الاستخدام الحالي لنشر المحتوى لدى مستخدم IG.
`insights`	تمثل أدوات قياس التفاعل على مواقع التواصل الاجتماعي لدى مستخدم IG.
`instagram_backed_threads_user`	يمثل حساب Threads المدعوم من حساب Instagram.
`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 آخر.
`upcoming_events`	قائمة الأحداث التي يستضيفها هذا الحساب الاحترافي على Instagram.
`collaboration_invites`	تمثل مجموعة من سمات الكائن `IG Media` (media_id، وmedia_owner_username، وcaption، media_url) التي تمت دعوة مستخدم IG للتعاون فيها.
`collaborative_media`	يمثل مجموعة من وسائط IG حيث يكون مستخدم IG مساهمًا مقبولاً. لا يتضمن الوسائط التي يملكها المستخدم مباشرة. لا يتوفر سوى لواجهة Instagram API مع تسجيل الدخول إلى فيسبوك فقط.

الاستجابة

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

{
  "<FIELD>":"<VALUE>",
  ...
}

مثال على cURL

الطلب

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

الاستجابة

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

التحديث

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

الحذف

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