المستخدم

يمكن أن يمثل الملف الشخصي لمستخدم Instagram.

تم تقديم معرفات المستخدم على مستوى التطبيق (ASIDs) بالإصدار 11.0 لواجهة API. ويمكنك متابعة الاستعلام عن المستخدمين بواسطة معرفات المستخدم الأولية لديهم أو معرفات المستخدم على مستوى التطبيق المكافئة، ومع ذلك ستستقبل استدعاءات الإصدار 11.0 والإصدارات الأحدث معرفات المستخدم على مستوى التطبيق ضمن الاستجابة.

ستحل معرفات المستخدم على مستوى التطبيق (ASIDs) محل معرفات المستخدم الأولية خلال عامين تقريبًا، عندما يتم إيقاف استخدام الإصدار 10.0، لذا نوصي ببدء تعيين مستخدمي التطبيق إلى معرفات المستخدم على مستوى التطبيق المكافئة.

الإنشاء

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

القراءة

GET /{user-id}

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

القيود

معرفات المستخدمين القديمة لواجهة API في Instagram غير مدعومة.

المتطلبات

النوع	المتطلب
رموز الوصول	مستخدم Instagram
الأذونات	`instagram_graph_user_profile`. كما يتطلب الحقل`media_countinstagram_graph_user_media` أيضًا.

بنية الطلب

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

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

العنصر النائب	القيمة
`{api-version}` سلسلة	إصدار واجهة API.
`{user-id}` مطلوب سلسلة	معرف المستخدم على مستوى التطبيق لمستخدم التطبيق (الإصدار 11.0 والإصدارات الأحدث) أو معرف المستخدم الأولي (كل الإصدارات).

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

يمكن تضمين معلمات سلسلة الاستعلام التالية لتعزيز الطلب.

المفتاح	القيمة
`access_token` مطلوب سلسلة	يمثل رمز وصول مستخدم Instagram لدى مستخدم التطبيق.
`fields` قائمة مفصولة بفاصلة	قائمة مفصولة بفاصلة تتضمن الحقول وعناصر الربط التي ترغب في إرجاعها. إذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

الحقول

يمكنك استخدام معلمة سلسلة الاستعلام fields لطلب الحقول التالية لدى المستخدم.

اسم الحقل	الوصف
`account_type`	نوع حساب المستخدم. يمكن أن يكون `BUSINESS` أو `MEDIA_CREATOR` أو `PERSONAL`.
`id`	معرف المستخدم على مستوى التطبيق لمستخدم التطبيق (الإصدار 11.0 والإصدارات الأحدث) أو معرف المستخدم الأولي (الإصدار 10.0 والإصدارات الأقدم).
`media_count`	عدد الوسائط المتوفرة حول المستخدم. يتطلب هذا الحقل الإذن `instagram_graph_user_media`.
`username`	اسم المستخدم الخاص بالمستخدم.

عناصر الربط

يمكنك طلب عناصر الربط التالية كمعلمات المسار أو من خلال استخدام معلمة سلسلة الاستعلام fields.

عنصر الربط	الوصف
`media`	يمكن الحصول على قائمة الوسائط حول المستخدم.

الاستجابة

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

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

مثال على cURL

الطلب

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

الاستجابة

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

التحديث

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

الحذف

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