GitHub

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

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

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

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • הפעלת השירותים הבאים
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

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

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

  • ב-GitHub, בהתאם לדרישות שלכם, מבצעים את המשימות הבאות:

    הגדרת המחבר

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

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

      כניסה לדף Connections

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

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

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

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

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

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

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

      10. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
        • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
          • בסיסי: אימות HTTP בסיסי.
          • ‫Digest: אימות HTTP מסוג Digest.
        • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
        • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
        • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. אלה סוגי האימות שנתמכים:
          • אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
          • תמיד: החיבור תמיד מופעל באמצעות SSL.
          • לעולם לא: החיבור לא מופעל באמצעות SSL.
          • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
        • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
          1. לוחצים על + הוספת יעד.
          2. בוחרים סוג יעד.
            • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

      11. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
      12. לוחצים על הבא.
    5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
      1. סוג היעד: בוחרים סוג יעד.
        • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
        • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

        כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

      2. לוחצים על הבא.
    6. בקטע אימות, מזינים את פרטי האימות.

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

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

    הגדרת אימות

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

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

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

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

    OAuth 2.0 – סוג החיבור של קוד ההרשאה

    שם השדה פרטים
    מיקום europe-west1
    מחבר GitHub
    גרסת המחבר 1
    שם החיבור GitHub-connector
    הפעלת Cloud Logging לא
    חשבון השירות Your_Project_Number@serviceaccount
    OwnerLogin souvikg-Your_Owner_Login
    סכימה
    מספר הצמתים המינימלי 2
    מספר הצמתים המקסימלי 50
    מזהה לקוח ClientID
    היקפים repo repo:status repo_deployment
    סוד לקוח סוד לקוח
    גרסת סוד 1

    סכימות והיקפים של GitHub

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

    מידע נוסף על היקפים זמין במאמר היקפים ב-GitHub.

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

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

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

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

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

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

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

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

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

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

    פעולה

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

    פעולת UpdatePullRequestBranch

    הפעולה הזו מעדכנת את הענף של בקשת המיזוג.

    פרמטרים של קלט לפעולה UpdatePullRequestBranch

    שם סוג תיאור
    PullRequestId מחרוזת מזהה הצומת של בקשת משיכה.
    ExpectedHeadOid מחרוזת מזהה האובייקט של הפניה לראש הענף במאגר המרכזי.
    UpdateMethod מחרוזת שיטת העדכון של הענף שבה רוצים להשתמש. ברירת המחדל היא MERGE. הערכים המותרים הם MERGE ו-REBASE.

    פרמטרים של פלט הפעולה AppsDeployStatus

    הפעולה הזו מחזירה את הסטטוס 200 (OK) ומעדכנת את הענף של בקשת המיזוג.

    דוגמה להגדרת הפעולה UpdatePullRequestBranch מופיעה במאמר דוגמאות.

    פעולת MergePullRequest

    הפעולה הזו ממזגת בקשת משיכה.

    פרמטרים של קלט לפעולה MergePullRequest

    שם סוג תיאור
    PullRequestId מחרוזת מזהה הצומת של בקשת המשיכה שרוצים למזג.
    ExpectedHeadOid מחרוזת מזהה OID שאליו צריך להתאים את הפניה ל-head של בקשת משיכה כדי לאפשר מיזוג. אם לא מציינים מזהה, לא מתבצעת בדיקה.
    CommitHeadline מחרוזת כותרת ההתחייבות לשימוש בהתחייבות למיזוג. אם לא מציינים כותרת, המערכת משתמשת בהודעת ברירת המחדל.
    CommitBody מחרוזת הודעת ה-commit שבה ישתמשו למיזוג. אם לא מציינים הודעה, המערכת משתמשת בהודעת ברירת המחדל.
    MergeMethod מחרוזת שיטת המיזוג שבה רוצים להשתמש. ברירת המחדל היא MERGE. הערכים המותרים הם MERGE,‏ SQUASH ו-REBASE.
    AuthorEmail מחרוזת כתובת האימייל שתשויך למיזוג הזה.

    פרמטרים של פלט של הפעולה MergePullRequest

    הפעולה הזו מחזירה את הסטטוס 200 (OK) וממזגת את בקשת המשיכה.

    דוגמה להגדרת הפעולה MergePullRequest מופיעה במאמר דוגמאות.

    הפעולה DownloadFile

    הפעולה הזו מורידה קובץ מהמאגר.

    פרמטרים של קלט לפעולה DownloadFile

    שם סוג חובה תיאור
    נתיב String לא נכון הנתיב של הקובץ במאגר.
    ענף String לא נכון שם הענף במאגר שממנו הורד הקובץ. ערך ברירת המחדל הוא הענף הראשי.
    LocalPath String לא נכון הנתיב המקומי שבו הקובץ נשמר אחרי ההורדה.
    OutputStream בינארי נכון מופע של זרם פלט שאליו נכתבים נתוני הקובץ. הזרם של הפלט משמש רק אם לא צוין LocalPath.

    דוגמה להגדרת הפעולה DownloadFile מופיעה במאמר דוגמאות.

    הפעולה UploadFile

    הפעולה הזו מעלה קובץ למאגר.

    פרמטרים של קלט לפעולה UploadFile

    שם סוג חובה תיאור
    נתיב String לא נכון הנתיב של הקובץ במאגר.
    ענף String לא נכון שם הענף במאגר שאליו רוצים להעלות את הקובץ. ערך ברירת המחדל הוא הענף הראשי.
    CommitMessage String לא נכון ההודעה שמתארת את השינויים שבוצעו במהלך העלאת הקובץ.
    SHA String לא נכון הגיבוב של הקובץ שמשמש לאימות ולעדכון של קבצים קיימים במאגר.
    CommitterName String לא נכון המשתמש שמבצע את השמירה של הקובץ. ערך ברירת המחדל הוא המשתמש המאומת.
    CommitterEmail String לא נכון כתובת האימייל של המשתמש שביצע את השמירה של הקובץ. ערך ברירת המחדל הוא המשתמש המאומת.
    AuthorName String לא נכון השם של היוצר שהעלה את הקובץ. ערך ברירת המחדל הוא השם של מי שביצע את השמירה או של המשתמש המאומת.
    AuthorEmail String לא נכון כתובת האימייל של היוצר שהעלה את הקובץ. ערך ברירת המחדל הוא כתובת האימייל של המשתמש שביצע את השליחה או של המשתמש המאומת.
    LocalPath String לא נכון הנתיב המקומי שבו הקובץ נשמר אחרי ההורדה.
    InputStream בינארי נכון מופע של זרם קלט שמשמש לקריאת נתוני הקובץ. הפרמטר הזה משמש רק אם לא צוין LocalPath.
    FileData String לא נכון מחרוזת בקידוד Base64 שמייצגת את תוכן הקובץ. הפרמטר הזה משמש רק אם לא צוינו LocalPath ו-InputStream.

    דוגמה להגדרת הפעולה UploadFile מופיעה במאמר דוגמאות.

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

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

    דוגמה – UpdatePullRequestBranch

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

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Action.
    2. בוחרים את הפעולה UpdatePullRequestBranch ולוחצים על סיום.
    3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
            {
    "PullRequestId": "PR_kwDOLywhW8537gcA"
      }

      4. אם הפעולה מצליחה, ערך הפרמטר UpdatePullRequestBranch response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

             {
    "pullrequestid": "PR_kwDOLywhW8537gcA"
       }

    דוגמה – MergePullRequest

    בדוגמה הזו מתבצע מיזוג של בקשת משיכה.

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Action.
    2. בוחרים את הפעולה MergePullRequest ולוחצים על סיום.
    3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
            {
    "PullRequestId": "PR_kwDOLywhW8537gcA",
    "CommitHeadline": "Google MERGE",
    "CommitBody": "This is Google Merge"
      }

      4. אם הפעולה מצליחה, ערך הפרמטר MergePullRequest response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

              {
    "pullrequestid": "PR_kwDOLywhW8537gcA"
        }

    דוגמה – הורדת קובץ מהמאגר

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
    2. בוחרים את הפעולה DownloadFile ולוחצים על סיום.
    3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
            {
    "Repository": "Google_GitHub_Testing",
    "Path": "Test_Document.txt"
      }

      4. אם הפעולה מצליחה, ערך הפרמטר DownloadFile response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

          {
      "Success": true,
      "Details": null,
      "FileData": "SGkgR29vZ2xlIEhvdyBSIHlvdT8KCkknbSBmaW5l"
    }

    דוגמה – העלאת קובץ למאגר

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
    2. בוחרים את הפעולה UploadFile ולוחצים על סיום.
    3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
            {
    "Path": "Sample.txt",
    "Repository": "Google_GitHub_Testing",
    "AuthorName": "Cruz",
    "FileData": "dXBsb2FkIGR0YWEgaW50byB0aGlzIGZpbGUgZnJvbSBHQ1A=",
    "CommitMessage": "TestCommitFrom GCPcloud",
    "CommitterEmail": "Charlie@altrostrat.com",
    "CommitterName": "Charlie",
    "AuthorEmail": "cruz@altrostrat.com"
      }

      4. אם הפעולה מצליחה, ערך הפרמטר UploadFile response connectorOutputPayload של המשימה יהיה דומה לדוגמה הבאה:

          {
      "Success": false,
      "Details": "Invalid request.\n\n\"sha\" wasn't supplied. ",
      "CommitSHA": null,
      "FileSHA": null
    }

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

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

    דוגמה – הצגת כל הסניפים

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Branches מהרשימה Entity.
    3. בוחרים את הפעולה List ולוחצים על סיום.
    4. בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות.

    דוגמה – הצגת רשימה של כל הקומיטים

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Commits מהרשימה Entity.
    3. בוחרים את הפעולה List ולוחצים על סיום.
    4. בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות.

    לתשומת ליבכם

    • ‫Commits הוא שם הישות. חובה להעביר את הערך של משפט הסינון באמצעות גרשיים בודדים ('), למשל City='Redwood City'. כאשר City הוא שם העמודה ו-Redwood city הוא הערך.
    • אפשר להשתמש בסעיף filter כדי לסנן רשומות על סמך עמודות. לדוגמה, אם יש 20 רשומות עם name = demo16975280986860, אפשר לסנן רשומות עם העמודה Address='Redwood City' והאזור region='us-east1'.

    אפשר לבצע את הפעולה List בישויות הבאות:

    CommitComments, Forks, IssueComments, Issue, IssueAssignees, AssignableUser,Labels, Milestones, PullRequestReviews, PullRequests, PullRequestComments, ReleaseAssets, Releases, Watcher, Users, Repositories, Collaborators, OrganizationTeams, OrganizationsMannequins, OrganizationMember, Organization, Licenses, LicensePermission, LicenseLimitation, LicenseConditions, Projects, and PullRequestReviewRequests

    דוגמה – קבלת רשומת סניפים

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Branches מהרשימה Entity.
    3. בוחרים את הפעולה Get ולוחצים על סיום.
    4. כאן, מזהה הישות מוגדר כ-4. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 4 בשדה Default Value.

    דוגמה – שליפת רשומת מאגרים

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Repositories מהרשימה Entity.
    3. בוחרים את הפעולה Get ולוחצים על סיום.
    4. מגדירים את מזהה הישות ל-4, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 4 בשדה Default Value.

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

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

    אפשר לבצע את הפעולה Get על הישויות הבאות:

    CommitComments, Commits, IssueAssignees, Labels, Milestones, PullRequestReviews, PullRequests, PullRequestComments, ReleaseAssets, Release, Topics, Users, Collaborators, Organizations, and Licenses

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

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Issues מהרשימה Entity.
    3. בוחרים את הפעולה Create ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
           {
  "Title": "Google_Cloud_GitHub_Issues_Create",
  "Body": "Please check hence raising the Feature Request for the same."
     }

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

           {
  "Id": "I_kwDOLywhW86Sd-xF"
     }

    דוגמה – יצירת רשומה של בקשות משיכה

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות PullRequests מהרשימה Entity.
    3. בוחרים את הפעולה Create ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
           {
  "BaseRefName": "main",
  "HeadRefName": "New_Branch",
  "Title": "DEMO_Google_Cloud_PULLRequest",
  "Body": "This is demo Google_Cloud pull"
     }

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

            {
  "Id": "PR_kwDOLywhW8537gcA"
      }

    דוגמה – יצירת רשומה של מאגרי מידע

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Repositories מהרשימה Entity.
    3. בוחרים את הפעולה Create ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
           {
  "Name": "Google_Cloud_DEMO_REPO",
  "OwnerId": "O_kgDOCaxLsg",
  "Visibility": "PUBLIC"
     }

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

            {
  "Id": "R_kgDOMhWBEQ"
      }

    דוגמה – עדכון של רשומה של בעיות

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Issues מהרשימה Entity.
    3. בוחרים את הפעולה Update ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
           {
  "Title": "New_Updated_Google_Cloud_Issue",
  "Body": "Newly Updated from Google_Cloud"
     }
    5. מגדירים את הערך של entityId ל-I_kwDOLywhW86Sd-xF. כדי להגדיר את הערך של filterClause, לוחצים על entityId ואז מזינים I_kwDOLywhW86Sd-xF בשדה Default Value.

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

           {
  "Id": "I_kwDOLywhW86Sd-xF"
     }

    דוגמה – עדכון של רשומת PullRequests

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות PullRequests מהרשימה Entity.
    3. בוחרים את הפעולה Update ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
            {
  "Title": "Updated_Google_Cloud_PULL",
  "Body": "Update New pull Body"
      }
    5. מגדירים את הערך של entityId ל-PR_kwDOLywhW8537gcA. כדי להגדיר את הערך של filterClause, לוחצים על entityId ואז מזינים PR_kwDOLywhW8537gcA בשדה Default Value.

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

            {
  "Id": "PR_kwDOLywhW8537gcA"
      }

    דוגמה – עדכון רשומה של מאגרים

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות Repositories מהרשימה Entity.
    3. בוחרים את הפעולה Update ולוחצים על סיום.
    4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
            {
  "Name": "Updated_New_Google_Cloud_Repo"
      }
    5. מגדירים את הערך של entityId ל-R_kgDOMhWBEQ. כדי להגדיר את הערך של filterClause, לוחצים על entityId ואז מזינים R_kgDOMhWBEQ בשדה Default Value.

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

            {
  "Id": "R_kgDOMhWBEQ"
      }

    דוגמה – מחיקת רשומה של בקשות לביקורת על בקשות משיכה

    1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
    2. בוחרים באפשרות PullRequestReviewRequests מהרשימה Entity.
    3. בוחרים את הפעולה Delete ולוחצים על סיום.
    4. מגדירים את הערך של filterClause, לוחצים על filterClause ומזינים PullRequestId= 'PR_kwDOLywhW85yNWPa' and RequestedReviewerUserId= 'U_kgDOCebPLA' בשדה Default Value.

      5. בדוגמה הזו, PullRequestReviewRequests הוא שם הטבלה והערך של filterClause צריך להיות מועבר ישירות.
      לדוגמה, PullRequestId= 'PR_kwDOLywhW85yNWPa' ו-RequestedReviewerUserId= 'U_kgDOCebPLA'.
      בדוגמה הזו, הערכים הייחודיים של המפתח הראשי שצריך להעביר הם PullRequestId= 'PR_kwDOLywhW85yNWPa' ו-RequestedReviewerUserId= 'U_kgDOCebPLA'.

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

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

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

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

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

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