אינסטגרם

מחבר Instagram מאפשר לכם לבצע פעולות של הוספה, מחיקה, עדכון וקריאה ב-Instagram.

לפני שמתחילים

לפני שמשתמשים במחבר של Instagram, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

    אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.

הגדרת אינסטגרם

כדי ליצור אפליקציה שמשתלבת עם Instagram, מבצעים את הפעולות הבאות:

  • הגדרת חשבון עסקי באינסטגרם
  • יצירת חשבון מפתח ב-Facebook
  • הגדרת אימות לקוח OAuth2.0
  • הגדרת פרטי ההיקף
  • הגדרת פרטים של כתובת URL להפניה אוטומטית

הגדרת חשבון עסקי באינסטגרם

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

  5. מתחברים לדף פייסבוק.
  6. במהלך ההגדרה, אינסטגרם מציעה לכם אפשרות להתחבר לדף פייסבוק. הוספת התיאור היא אופציונלית, אבל מומלצת כדי לקבל גישה לכל התכונות.

    אתם יכולים ליצור דף פייסבוק חדש ישירות בתהליך ההגדרה או לקשר לדף קיים.

יצירת חשבון פיתוח בפייסבוק ליצירה ולהגדרה של אפליקציות

מתחברים באמצעות חשבון פייסבוק שיצרתם קודם.

  1. מתחברים לחשבון הפיתוח ב-Facebook.
  2. לוחצים על האפליקציות שלי ובוחרים באפשרות יצירת אפליקציה.
  3. בוחרים את הפלטפורמה של האפליקציה מתוך רשימת האפשרויות, כמו iOS,‏ Android,‏ אינטרנט וכו'.
  4. מזינים מידע בסיסי באפליקציה, כמו שם, כתובת אימייל וקטגוריה.
  5. אחרי שמזינים את המידע הדרוש, לוחצים על יצירת מזהה אפליקציה כדי ליצור מזהה ייחודי לאפליקציה.
  6. מוסיפים פרטים ספציפיים לפלטפורמה, כמו מזהה החבילה של iOS, שם החבילה של Android וכתובות URL של מדיניות הפרטיות, ומגדירים את הדומיינים של האפליקציה.
  7. מידע על יצירת אפליקציה זמין במאמר יצירת אפליקציה.

  8. מגדירים את Instagram Graph API.
    1. עוברים להגדרות של האפליקציה.
    2. מוסיפים את המוצר Instagram Graph API לאפליקציה דרך מרכז הבקרה.
    3. במרכז הבקרה של האפליקציה, לוחצים על הגדרה בקטע Instagram.
    4. קובעים את ההגדרות בהתאם לצרכים של האפליקציה, כולל הגדרת הרשאות. מידע על הגדרת Instagram Graph API זמין במאמר בנושא Instagram Graph API.
  9. להוסיף הרשאות גישה.

    מבקשים את ההרשאות הדרושות לנתונים שאתם צריכים. בדרך כלל ההרשאות האלה כוללות את ההרשאות instagram_basic, ‏ instagram_manage_comments, ‏ instagram_content_publish,‏ instagram_manage_insights, ‏ pages_show_list וכו'.

    כל הרשאה מגדירה את סוג הנתונים או הפעולות שאפשר לבצע באמצעות ה-API. למידע על הרשאות, אפשר לעיין במאמר בנושא הרשאות ואימות.

  10. אם האפליקציה שלכם דורשת נתונים נוספים, אתם צריכים לשלוח אותה לבדיקת אפליקציות על ידי פייסבוק. לשם כך, עליך לתאר איך האפליקציה שלך משתמשת בנתונים, באמצעות צילום מסך של השימוש בפועל, כדי לוודא שאתה עומד בדרישות המדיניות של הפלטפורמה.

  11. מקשרים את החשבון העסקי ב-Instagram.
    1. חשוב לוודא שחשבון האינסטגרם שלכם הוא חשבון עסקי או חשבון יוצר, כי Instagram Graph API לא פועל עם חשבון אישי.
    2. קישור חשבון Instagram לדף Facebook.

    הגדרת אימות לקוח OAuth2.0

    1. מתחברים אל Meta for Developers באמצעות פרטי הכניסה שלכם ל-Facebook.
    2. לוחצים על הכרטיסייה 'אפליקציות' ובוחרים את אפליקציית Meta שיצרתם בשלב הקודם.
    3. בתפריט, לוחצים על הגדרות האפליקציה > בסיסי.
    4. מציגים את סוד האפליקציה, שהוא סוד הלקוח. לוחצים על 'הצגה', תתבקשו להזין את הסיסמה של החשבון, ושומרים את סוד הלקוח לשימוש מאוחר יותר.
    5. בתפריט, לוחצים על אפליקציה הגדרות > מתקדם. מחפשים את טוקן הלקוח, שהוא מזהה הלקוח. אם צריך, אפשר לאפס אותו.

    הגדרת פרטי היקף ההרשאות

    אפשר להגדיר את ההיקפים בהתאם לצרכים העסקיים. ההיקפים הוגדרו כ-instagram_basic, ‏ pages_show_list, ‏ pages_read_engagement.

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

    1. מתחברים אל Meta for Developers באמצעות פרטי הכניסה שלכם ל-Facebook.
    2. לוחצים על הכרטיסייה 'אפליקציות' ובוחרים את אפליקציית Meta שיצרתם בשלב הקודם.
    3. בתפריט, לוחצים על facebook התחברות > הגדרות.
    4. מדביקים את כתובת ה-URL להפניה אוטומטית שנוצרה בקטע Valid OAuth Redirect URIs בשדה הנדרש.

    הגדרת המחבר

    החיבור ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:

    1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

      כניסה לדף Connections

    2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
    3. בקטע מיקום, בוחרים את המיקום של החיבור.
      1. אזור: בוחרים מיקום מהרשימה הנפתחת.

        אזורים נתמכים למחברים:

        רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

      2. לוחצים על הבא.
    4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
      1. מחבר: בוחרים באפשרות Instagram מהרשימה הנפתחת של המחברים הזמינים.
      2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
      3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

        השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:

        • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
        • האותיות צריכות להיות קטנות.
        • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
        • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
      4. אפשר גם להזין תיאור למופע החיבור.
      5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
      6. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

        • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
        • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

        צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר טרנזקציות לחיבור מסוים, צריך יותר צמתים, ולהפך – כדי לעבד פחות טרנזקציות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

      7. רמת הפירוט: רמת הפירוט של החיבור, משתנה מ-1 עד 5. רמת פירוט גבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
      8. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
      9. לוחצים על הבא.
    5. בקטע אימות, מזינים את פרטי האימות.
      1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

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

        • הרשאת קוד אימות OAuth 2.0
      2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

      3. לוחצים על הבא.
    6. בדיקה: בודקים את פרטי החיבור והאימות.
    7. לוחצים על יצירה.

    דוגמאות להגדרת חיבור

    בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים את החיבור לאינסטגרם.

    סוג החיבור לאינטרנט באינסטגרם

    שם השדה פרטים
    מיקום europe-west1
    מחבר אינסטגרם
    גרסת המחבר 1
    שם החיבור google-cloud-instagram
    חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
    רמת הפירוט 5
    מספר הצמתים המינימלי 2
    מספר הצמתים המקסימלי 50
    מזהה לקוח CLIENT_ID
    היקפים instagram_basic,pages_show_list,pages_read_engagement
    סוד לקוח CLIENT_SECRET
    גרסה של סוד 2

    הגדרת אימות

    מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

    • הרשאת קוד אימות OAuth 2.0
      • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
      • ‫Scopes: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
      • סוד הלקוח: סוד הלקוח שמשמש לבקשת אסימוני גישה.
      • גרסת הסוד: הגרסה של הסוד שמכילה את סוד הלקוח.

    אישור מחדש של קוד הרשאה

    אם אתם משתמשים בסוג האימות Authorization code וביצעתם שינויים בהגדרות של האפליקציה שלכם ב-Azure AD, אתם צריכים להעניק מחדש הרשאה לחיבור שלכם ל-Azure AD. כדי לחדש את הרשאת הגישה לחיבור:

    1. לוחצים על החיבור הרצוי בדף החיבורים.

      ייפתח הדף עם פרטי החיבור.

    2. לוחצים על עריכה כדי לערוך את פרטי החיבור.
    3. בודקים את הפרטים של OAuth 2.0 – קוד הרשאה בקטע אימות.

      אם צריך, מבצעים את השינויים הנדרשים.

    4. לוחצים על Save. הלחיצה תעביר אתכם לדף פרטי החיבור.
    5. בקטע אימות, לוחצים על עריכת הרשאה. מוצגת החלונית Authorize (אישור).
    6. לוחצים על Authorize.

      אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

    שלבים נוספים אחרי יצירת החיבור

    אם בחרתם באפשרות OAuth 2.0 - Authorization code לאימות, אתם צריכים לבצע את השלבים הנוספים הבאים אחרי יצירת החיבור:

    1. בדף החיבורים, מאתרים את החיבור החדש.

      שימו לב שהסטטוס של המחבר החדש יהיה נדרשת הרשאה.

    2. לוחצים על דרושה הרשאה.

      יוצג לוח עריכת הרשאה.

    3. מעתיקים את הערך של Redirect URI (ה-URI של ההפניה האוטומטית) לאפליקציה החיצונית.
    4. מאמתים את פרטי ההרשאה.
    5. לוחצים על Authorize.

      אם ההרשאה מתבצעת בהצלחה, סטטוס החיבור יהיה פעיל בדף החיבורים.

    ישויות, פעולות ופעולות

    כל Integration Connectors מספקים שכבת הפשטה לאובייקטים של האפליקציה המחוברת. אפשר לגשת לאובייקטים של אפליקציה רק דרך ההפשטה הזו. ההפשטה מוצגת לכם כישויות, פעולות ופעילויות.

    • ישות: ישות היא אובייקט או אוסף של מאפיינים באפליקציה או בשירות המקושרים. ההגדרה של ישות משתנה ממחבר למחבר. לדוגמה, במחבר של מסד נתונים, הטבלאות הן הישויות. במחבר של שרת קבצים, התיקיות הן הישויות. במחבר של מערכת הודעות, התורים הם הישויות.

      עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

    • פעולה: פעולה היא הפעילות שאפשר לבצע על ישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

      בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

    • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

    מגבלות המערכת

    מחבר Instagram יכול לעבד 2 טרנזקציות בשנייה, לכל צומת, ומגביל טרנזקציות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

    מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

    דוגמאות לפעולות

    בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

    דוגמה – רשימה של כל רכיבי IGMedia

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות IGMedia מהרשימה Entity.
    3. בוחרים את הפעולה List ולוחצים על סיום.

    דוגמה – רשימה של כל AccountFollowersNonfollowers

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות 'חשבון' 'עוקבים' 'לא עוקבים' מהרשימה Entity.
    3. בוחרים את הפעולה List ולוחצים על סיום.
    4. מגדירים את סעיף הסינון ל-List single AccountFollowersNonfollowers. כדי להגדיר את פסוקית הסינון, בקטע מיפוי נתונים של כלי מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים Metric='reach' בשדה ערך קלט ובוחרים את פסוקית הסינון כמשתנה מקומי.

    כדי לבצע פעולה עם הישות AccountFollowersNonfollowers, צריך להשתמש בסעיף המסנן במיפוי הנתונים של המשימות.

    דוגמה – קבלת IGMedia יחיד

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות IGMedia מהרשימה Entity.
    3. בוחרים את הפעולה Get ולוחצים על סיום.
    4. מגדירים את מזהה הישות ל-Get single IGMedia. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 18008309540391873 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

    דוגמה – קבלת נתונים של MediaInsightReels

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות MediaInsightReels מהרשימה Entity.
    3. בוחרים את הפעולה List ולוחצים על סיום.
    4. מגדירים את פסוקית הסינון ל-Get single MediaInsightReels. כדי להגדיר את פסוקית הסינון, בקטע מיפוי נתונים של כלי מיפוי הנתונים, לוחצים על פתיחת כלי מיפוי הנתונים, מזינים MediaId='18018014180193817' בשדה ערך קלט ובוחרים את פסוקית הסינון כמשתנה מקומי.

    כדי לבצע פעולת Get עבור הישויות הבאות, צריך להשתמש בסעיף הסינון במיפוי הנתונים של המשימות: MediaInsightReels, ‏ MediaInsights, ‏ MediaInsightsPost, ‏ AccountFollowersNonfollowers ו-AccountContactButtonType.

    דוגמה – מחיקת תגובה

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות 'הערות' מהרשימה Entity.
    3. בוחרים את הפעולה Delete ולוחצים על סיום.
    4. מגדירים את מזהה הישות לערך Delete Comments (מחיקת תגובות). כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 18435078259055638 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

    דוגמה – יצירת תגובה

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות 'הערות' מהרשימה Entity.
    3. בוחרים את הפעולה Create ולוחצים על סיום.
    4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
       {
      "MediaId": "18008309540391873",
      "Text": "The Universe is with you"
      }

      הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

      {
      "Id": "18351045133102133"
      }

    דוגמה – כתיבת תשובה

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות 'תגובות' מהרשימה Entity.
    3. בוחרים את הפעולה Create ולוחצים על סיום.
    4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
       {
      "CommentId": "18022630739158714",
      "Text": "conquered" 
      }

      הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

      {
      "Id": "18167970637306971"
      }

    שימוש בחיבור לאינסטגרם בשילוב

    אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.

    • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
    • מידע על יצירה ושימוש במשימת Connectors ב-Application Integration זמין במאמר משימת Connectors.

    קבלת עזרה מקהילת Google Cloud

    אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

    המאמרים הבאים