LinkedIn

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

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

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

• מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
• נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
• מקצים את התפקידים roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor ב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר.
• מפעילים את השירותים הבאים:
  • ‫secretmanager.googleapis.com (Secret Manager API)
  • ‫connectors.googleapis.com (Connectors API)

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

הגדרת המחבר

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

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

   כניסה לדף Connections

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

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

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

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

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

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   8. מזהה החברה: מזהה החברה בלינקדאין שייחודי לארגון שלכם. אם מציינים את מזהה החברה בשאילתה, צריך להשתמש בפורמט הבא: urn:li:organization:COMPANY_ID.
   9. לוחצים על הבא.
   10. בקטע הרשאה, מזינים את הפרטים של מזהה הלקוח וסוד הלקוח.
       • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
       • היקף: רשימה מופרדת בפסיקים של היקפי הגישה הרצויים מחשבון המפתחים של LinkedIn.
       • סוד הלקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
       • ‫Secret version (גרסה של סוד): גרסת הסוד שנבחרה.
       כשמגדירים את אפליקציית ה-OAuth של צד שלישי, צריך להשתמש בכתובת ה-URI המורשית להפניה אוטומטית (כתובת URL של קריאה חוזרת):

       https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

       מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

   11. לוחצים על הבא.
   12. בדיקה: בודקים את פרטי החיבור והאימות.
   13. לוחצים על יצירה.

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

   מחבר LinkedIn יכול לעבד עד 5 עסקאות בשנייה, לכל צומת, ומגביל עסקאות מעבר למגבלה הזו. LinkedIn אוכפת מגבלה של 10,000 בקשות לכל משתמש כל 24 שעות.

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

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

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

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

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

   שימוש בחיבור ל-LinkedIn בשילוב

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

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

   ישויות

   מחבר LinkedIn תומך בישויות כמו תגובות ופרופילים. כדי להבין איך להגדיר את הישויות, אפשר לעיין בדוגמאות לישויות.

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

   דוגמה – רשימה של כל התגובות מדף הפרופיל ב-LinkedIn.

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

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

   דוגמה – קבלת פרופילים ממזהה ספציפי

   בדוגמה הזו, הפרופילים מאוחזרים על סמך המזהה מהישות Profiles.

   1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
   2. בוחרים באפשרות Profiles מהרשימה Entity.
   3. בוחרים את הפעולה GET ולוחצים על סיום.
   4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 2t7k5s4fgC בשדה Default Value (ערך ברירת מחדל).

      כאן, Id [KEY] הוא ערך המפתח הראשי של הישות Profiles.

   5. לוחצים על סיום.

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

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

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

   • איך משעים ומחדשים חיבור
   • איך עוקבים אחרי השימוש בכלי לחיבור נתונים
   • איך צופים ביומני המחברים