‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

מחבר Google Drive

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

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

גרסאות של מחבר Google Drive

המחבר ל-Google Drive תומך בשתי גרסאות:

‫Google Drive v1: משתמשים בגרסת המחבר הזו כדי לגשת ל-Google Drive v3 API.
‫Google Drive v2: אפשר להשתמש בגרסה הזו של המחבר כדי לגשת אל Google Drive v2 API.

מידע על יצירת חיבור ל-Google Drive זמין במאמר יצירה והגדרה של מחבר ל-Google Drive.

ישויות ופעולות נתמכות

מחבר Google Drive תומך בישויות ובפעולות הבאות:

ישות	תיאור	תפעול
`File`	מייצג קובץ ב-Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Folder`	מייצג תיקייה ב-Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Permission`	מייצג הרשאה לקובץ או לתיקייה ב-Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Drive`	מייצג כונן ב-Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`

דוגמאות לתרחישי שימוש ב-Application Integration מופיעות במאמר דוגמאות לתרחישי שימוש ב-Application Integration.

פעולות נתמכות

מחבר Google Drive תומך בפעולות הבאות:

CopyResource

תיאור: יוצר עותק של מקור מידע שצוין ב-Google Drive. אתם יכולים להגדיר שם חדש לקובץ המועתק ולציין את תיקיית היעד שלו על ידי הזנת רשימה של מזהי תיקיות אב .

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשאב שרוצים להעתיק.
`NewName`	String	כן	השם החדש של הקובץ שהועתק.
`ParentIDs`	String	לא	רשימה מופרדת בפסיקים של מזהי תיקיות אב שבהן הקובץ המועתק ימוקם. אם לא מציינים תיקייה, הקובץ יועתק לאותה תיקייה שבה הוא נמצא.
`IgnoreDefaultVisibility`	בוליאני	לא	ההגדרה הזו קובעת אם לעקוף את הגדרות ברירת המחדל לחשיפה של הקובץ החדש שנוצר. אם הדומיין מוגדר כך שכל הקבצים שמועלים גלויים כברירת מחדל, הגדרת הפרמטר הזה כ-True מבטלת את ההתנהגות הזו עבור הבקשה הספציפית הזו. ערך ברירת המחדל הוא False.
`IncludeLabels`	String	לא	רשימה מופרדת בפסיקים של מזהי התוויות שרוצים לכלול בחלק labelInfo של התשובה.
`IncludePermissionsForView`	String	כן	בשדה הזה מציינים אילו הרשאות צפייה נוספות לכלול בתשובה. הערך הנתמך מתפרסם.
`KeepRevisionForever`	בוליאני	לא	מציין אם לשמור את הגרסאות של הקובץ לתמיד. התכונה הזו פועלת רק בקבצים עם תוכן בינארי ב-Google Drive. אפשר לשמור עד 200 גרסאות של כל קובץ ללא הגבלת זמן. אם מגיעים למגבלה, צריך למחוק גרסאות קיימות כדי להוסיף גרסאות חדשות. ערך ברירת המחדל הוא False.
`OCRLanguage`	String	לא	השדה הזה מספק רמז לגבי השפה ל-OCR (זיהוי תווים אופטי) כשמייבאים קבצי תמונה. מציינים את השפה באמצעות קוד שפה בן שתי אותיות לפי תקן ISO 639-1, למשל, `en` לאנגלית, `de` לגרמנית.
`SupportsAllDrives`	בוליאני	כן	הפרמטר הזה מציין אם לעקוב אחרי השינויים בתיקייה 'האחסון שלי' ובתיקיות אחסון שיתופי. כדי להפעיל גישה לתיקיות באחסון השיתופי, צריך להגדיר את הפרמטר הזה כ-true. ערך ברירת המחדל הוא False.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`CopiedFileID`	String	המזהה של הקובץ שהועתק.
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה CopyResource ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה CopyResource ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
      
```

CreateFolder

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

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Name`	String	כן	השם של התיקייה.
`Description`	String	לא	התיאור של התיקייה.
`Starred`	בוליאני	לא	הפרמטר הזה מציין אם התיקייה מסומנת בכוכב. ערך ברירת המחדל הוא False.
`ParentIds`	String	כן	רשימה של מזהים של התיקיות הראשיות שבהן תיווצר התיקייה החדשה, כשהמזהים מופרדים בפסיקים.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.
`Id`	String	המזהה של התיקייה החדשה.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה CreateFolder ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה CreateFolder ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Description: permanently removes a file or folder from Google Drive. כדי להשתמש בפעולה הזו, צריך לספק את המזהה הייחודי של המשאב שרוצים למחוק.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשאב שרוצים למחוק.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה DeleteResource ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה DeleteResource ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Description: downloads a file from Google Drive

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של הקובץ להורדה.
`LocalFile`	String	לא	נתיב הקובץ ושם הקובץ שבו הקובץ יישמר. אם רוצים לשמור את הקובץ בזיכרון, משאירים את השדה הזה ריק.
`Encoding`	String	לא	סוג הקידוד של נתוני הקובץ. אם LocalFile ריק, נתוני הקובץ יוחזרו בקידוד שצוין. הערכים המותרים הם NONE ו-BASE64. ערך ברירת המחדל הוא BASE64.
`Overwrite`	בוליאני	לא	הפרמטר הזה קובע אם להחליף את הקובץ אם הוא כבר קיים כשמורידים אותו. ערך ברירת המחדל הוא False. כדי להחליף את הקובץ, צריך להגדיר את הפרמטר כ-True.
`FileFormat`	String	לא	הפורמט שבו אפשר להוריד את הקובץ. הגודל המקסימלי של הקובץ הוא 10MB. כדי להוריד את הקובץ בפורמט המקורי שלו, משאירים את הפרמטר הזה ריק. הפורמטים הנתמכים הם DOCX,‏ ODT,‏ RTF,‏ HTML,‏ TXT ו-PDF.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`FileData`	String	אם לא מציינים LocalFile, נתוני הקובץ יוחזרו באמצעות הקידוד שצוין.
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה DownloadFile ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה DownloadFile ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

תיאור: העברת קובץ או תיקייה למיקום אחר ב-Google Drive. צריך לספק את המזהה של מקור המידע שרוצים להעביר ואת המזהים של תיקיות ההורה החדשות.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשאב שרוצים להעביר.
`ParentIDs`	String	כן	רשימה של מזהים שמופרדים באמצעות פסיקים, לשימוש כתיקיות אב. לכל משאב בתיקיית אחסון שיתופי יכולה להיות רק תיקיית הורה אחת, ורק משתמשים עם הרשאה של 'ארגון קבצים' או 'ארגון' יכולים להעביר קבצים ותיקיות בתוך תיקיית אחסון שיתופי.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה MoveResource ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה MoveResource ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Description: מעדכן את המטא נתונים של קובץ או תיקייה ב-Google Drive. אפשר לשנות את השם, התיאור, סוג ה-MIME והאם הוא מסומן בכוכב.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשאב שאמור להתעדכן.
`Name`	String	כן	השם החדש של הקובץ המעודכן.
`Description`	String	לא	תיאור של הקובץ או התיקייה.
`MIMEType`	String	לא	סוג ה-MIME של הקובץ.
`Starred`	String	לא	הפרמטר הזה מציין אם המשאב מסומן בכוכב. ערך ברירת המחדל הוא False.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה UpdateResource ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה UpdateResource ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

תיאור: העלאת קובץ ל-Google Drive. חובה לציין את נתוני הקובץ ואת סוג ה-MIME שלו. אפשר גם לציין את תיקיית האב שבה הקובץ ימוקם ואת שם הקובץ של הקובץ שהועלה.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של הקובץ שרוצים להעלות.
`FileData`	String	כן	נתוני הקובץ שרוצים להעלות.
`MIMEType`	String	כן	סוג ה-MIME של הקובץ.
`ParentIDs`	String	לא	רשימה מופרדת בפסיקים של מזהי תיקיות אב שבהן הקובץ שהועלה ימוקם. אם לא מציינים תיקייה, הקובץ יועלה לתיקיית הבסיס ב"האחסון שלי" של המשתמש.
`Filename`	String	לא	השם של הקובץ שרוצים להעלות.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה UploadFile ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה UploadFile ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

תיאור: נרשמים לקבלת התראות על שינויים בקובץ ספציפי ב-Google Drive.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של הקובץ שאליו רוצים להירשם.
`Token`	String	כן	האסימון שישמש להרשמה לשינויים בקובץ.

פרמטרים של פלט

שם הפרמטר	סוג נתונים	תיאור
`Success`	String	הפרמטר הזה מציין אם הפעולה בוצעה בהצלחה או לא.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה SubscribeToFileChanges ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה SubscribeToFileChanges ולוחצים על סיום.

בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

תיאור: הרשמה לקבלת התראות על שינויים שמשתמש ספציפי ביצע ב-Google Drive.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשתמש שאליו רוצים לרשום מינוי.
`Token`	String	כן	הטוקן שישמש להרשמה לשינויים במשתמש.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה SubscribeToUserChanges ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה SubscribeToUserChanges ולוחצים על סיום.

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

תיאור: ביטול ההרשמה לקבלת התראות על משאב שנצפה בעבר.

פרמטרים של קלט

שם הפרמטר	סוג נתונים	חובה	תיאור
`Id`	String	כן	המזהה של המשאב שרוצים להפסיק את המעקב אחריו.
`Token`	String	כן	האסימון שמשמש להפסקת הצפייה במשאבים.

דוגמה לתרחיש שימוש

בדוגמה הבאה אפשר לראות איך מגדירים את הפעולה StopWatchingResources ב-Application Integration:

בתיבת הדו-שיח Configure connector task (הגדרת משימת מחבר), לוחצים על Actions (פעולות).
בוחרים את הפעולה StopWatchingResources ולוחצים על סיום.

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

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

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

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

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

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

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

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

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

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