התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

תיוג אנשים והוספת מיקום לפוסט דרך ה-API של Instagram

ה-API של Instagram מתייג אנשים באמצעות user_tags ומוסיף מקום באמצעות location_id, ושני השדות מוגדרים על הקונטיינר של המדיה לפני שהיא מתפרסמת. user_tags מקבל שמות משתמש ציבוריים, ובתמונות נדרשות קואורדינטות x ו-y בין 0.0 ל-1.0. Meta מתארת אותו לתמונות, לסרטונים ול-Stories. location_id מקבל את ה-ID של Page עם נתוני מיקום, ומוצאים אותו דרך ה-Pages Search API, שמחפש דפים.

easyCoexistence מפרסמת תמונות, קרוסלות, Reels ו-Stories עם publish_instagram_post, מ-Claude, מ-ChatGPT או מהקוד שלכם.

0.0 to 1.0

טווח הערכים של x ו-y ב-user_tags, שנמדד מקצה השמאלי והעליון של התמונה.

Images

היכן user_tags דורש את x ו-y: הם אופציונליים ב-Stories, והשדות חלים רק על תמונות ו-Stories.

Carousels

location_id אינו נתמך בתמונות או בסרטונים שבתוך קרוסלה, לפי מסמך המדיה של Meta.

USER_TAGGING_FAILURE

הערך config_issue כשהמדיה מתפרסמת בלי תיוגי המשתמשים שלה, ש-Meta מכנה הצלחה חלקית.

13 Mar 2018

מתי Meta פתחה תיוג של מיקומים ושל משתמשי Instagram ציבוריים בתמונות שפורסמו דרך ה-API, בתחילה לשותפי בטא.

איך מתייגים אנשים בפוסט?

מוסיפים את user_tags לקונטיינר. זה מערך של אובייקטים, שכל אחד מהם כולל את שם המשתמש של חשבון Instagram ציבורי, ובתמונה גם x ו-y: מספרים עשרוניים מ-0.0 עד 1.0 שמציינים את מרחקו של התיוג מקצה השמאלי והעליון. מיקום נכנס ל-location_id באותה קריאה, והקונטיינר מתפרסם אחר כך עם media_publish כרגיל.

An image container with a user tag and a location
POST /<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/team.jpg",
  "caption": "<CAPTION>",
  "user_tags": [
    { "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
  ],
  "location_id": "<PAGE_ID>"
}

אילו פוסטים מקבלים תיוגי משתמשים ומיקום?

מסמך המדיה של Meta מתאר את user_tags לתמונות, לסרטונים ול-Stories, כאשר x ו-y חלים רק על תמונות ועל Stories, ומפרט את הפרמטרים שכל קונטיינר מקבל. בקרוסלה המיקום נכנס לקונטיינר של הקרוסלה, כי location_id אינו נתמך בתמונות או בסרטונים שבתוכה:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

איך מוצאים location_id?

מחפשים Page. location_id הוא ה-ID של Page שמשויך למיקום, ומסמך Meta מפנה אל Pages Search API: GET /pages/search עם q ועם fields=id,name,location, ואז בדיקה שלה-Page שנבחר יש נתוני מיקום. Page בלי נתונים כאלה נכשל עם INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. החיפוש רץ על Graph API של Meta עם האסימון של אפליקציית Meta שלכם: אסימון משתמש, או, למידע ציבורי על Page בלבד, אסימון אפליקציה עם התכונה Page Public Metadata Access.

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

מה קורה אם תיוג לא מתחבר?

הפוסט יכול להיות עדיין באוויר. media_publish מחזיר אז את config_issue עם הערך USER_TAGGING_FAILURE, שפירושו שהמדיה פורסמה בלי תיוגי המשתמשים שלה. Meta מכנה זאת הצלחה חלקית, ומבקשת מאפליקציות לטפל בכך כאות לסנכרון מחדש ולא כשגיאה, כי מזהה המדיה תקף. פרסום מחדש ייצור פוסט שני.

האם תיוגי משתמשים עובדים עם Instagram Login?

מסמך המדיה של Meta מפרט את user_tags ואת location_id ליצירת קונטיינר, בלי לקשור אותם להתחברות מסוימת. לעומת זאת, העמוד על Instagram API עם Instagram Login קובע שההגדרה הזאת לא יכולה לגשת למודעות או לתיוג, בלי לומר איזה תיוג הכוונה. לפני שבונים על אחד הפרמטרים האלה עם Instagram Login, מפרסמים פוסט בדיקה ובודקים את התגובה ואת הפוסט עצמו.

איך מתייגים אנשים דרך easyCoexistence?

עדיין אי אפשר. publish_instagram_post יוצר את הקונטיינר בעצמו ואינו מקבל user_tags או location_id, ואסימונים של Instagram אינם נמסרים לקריאה משלכם. מפרסמים את הפוסט עם publish_instagram_post, ואז מוסיפים את התיוגים והמיקום באפליקציית Instagram, מאפשרות העריכה של הפוסט.

טעויות נפוצות

  • השארת x ו-y בתיוג של תמונה. Meta דורשת אותם בתמונות, ורק בסטוריז הם אופציונליים.
  • הזנת קואורדינטות בפיקסלים או באחוזים. x ו-y הם מספרים עשרוניים מ-0.0 עד 1.0, הנמדדים מקצה השמאלי והעליון.
  • הגדרת location_id בפריטים של הקרוסלה. Meta לא תומכת בו בתמונות או בסרטונים שבתוך קרוסלה.
  • תיוג של חשבון פרטי. user_tags מקבל שמות משתמש של חשבונות Instagram ציבוריים בלבד.
עושים את זה עם EasyCoexistence

הכלי אינו מקבל user_tags או location_id, ולכן מתייגים אנשים ומקומות באפליקציית Instagram, מאפשרות העריכה של הפוסט. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

אפשר לתייג חשבון Instagram פרטי דרך ה-API?

לא. מסמך המדיה של Meta קובע ש-user_tags מקבל שמות משתמש של חשבונות Instagram ציבוריים, ולכן חשבון פרטי לא ניתן לתיוג בדרך הזאת.

כמה אנשים אפשר לתייג בפוסט אחד?

מסמך Meta על user_tags לא מציין מקסימום. המגבלה של 20 שהוא מציין נוגעת לתיוגים של @ בכיתוב.

אפשר להוסיף מיקום ל-Story דרך ה-API?

לא. התחביר של Meta לקונטיינר של Story מפרט את user_tags, אבל לא את location_id.

אפשר לתייג מוצר במקום אדם?

תיוגי מוצרים הם תכונה נפרדת, שמסמך הסקירה של Meta מציין כנתמכת עם Facebook Login ועם Unified Login, ולא עם Instagram Login.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-