Smartsheet

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

גרסאות נתמכות

המחבר הזה תומך בגרסה 25.2.0.246 של Smartsheet.

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

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

  • בפרויקט שלכם ב-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)

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

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

הגדרת המחבר

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

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

    כניסה לדף Connections

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

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

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

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אפשר גם להזין תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. כותרת: אפשר לציין את השדה הזה כדי לזהות את שמות העמודות מהשורה הראשונה.
    8. הסתרת תווים של עיצוב: אפשר לציין את השדה הזה כדי להסתיר סמלי מטבע וסימני אחוז בערכים מספריים. הפעולה הזו תמיר את העמודות האלה מ-varchar ל-double.
    9. התעלמות משורות שלא נמצאו: אופציונלי. אם לא בוחרים באפשרות הזו ולא נמצאים מזהי שורות שצוינו, לא יימחקו שורות ותוחזר שגיאה מסוג 'לא נמצא'.
    10. רמת התאימות של הדוח: אפשר לציין את רמת התאימות של הנתונים שמוחזרים.
    11. Use Full File Paths As Table Names: אפשר לציין את השדה הזה כדי לכלול את נתיב הקובץ המלא בשם של טבלה או תצוגה שנחשפות, בהתאם לגיליון או לדוח.
    12. מקור הערך: אפשרות להגדיר אם התא ישתמש בשדות הערך כערך שלו או בשדה DisplayValue.
    13. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

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

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

    14. אם רוצים, אפשר ללחוץ על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    15. לוחצים על הבא.
  5. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Smartsheet תומך בסוגי האימות הבאים:

      • ‫OAuth2.0 – קוד הרשאה
      • טוקן גישה אישי
    2. לוחצים על הבא.
  6. בדיקה: בודקים את פרטי החיבור והאימות.
  7. לוחצים על יצירה.

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

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

סוג החיבור לאימות OAuth 2.0

שם השדה פרטים
מיקום us-central1
מחבר smartsheet
גרסת המחבר 1
שם החיבור smartsheet-oauth-connection
חשבון השירות my-service-account@my-project.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מזהה לקוח CLIENT_ID
היקפים ADMIN_SHEETS, ADMIN_SIGHTS, ADMIN_USERS, ADMIN_WEBHOOKS, ADMIN_WORKSPACES, CREATE_SHEETS, CREATE_SIGHTS, DELETE_SHEETS, DELETE_SIGHTS, READ_CONTACTS, READ_EVENTS, READ_SHEETS, READ_SIGHTS, READ_USERS, SHARE_SHEETS, SHARE_SIGHTS, WRITE_SHEETS
סוד לקוח CLIENT_SECRET
גרסה של סוד 1
כתובת אתר להרשאה https://app.smartsheet.com/b/authorize

סוג החיבור לאימות טוקן גישה אישי

שם השדה פרטים
מיקום us-central1
מחבר smartsheet
גרסת המחבר 1
שם החיבור smartsheet-accesstoken-connection
חשבון השירות my-service-account@my-project.iam.gserviceaccount.com
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
טוקן גישה אישי PERSONAL_ACCESS_TOKEN
גרסה של סוד 3

אפשר ליצור חשבון Smartsheet באמצעות הקישור Smartsheet Login (כניסה ל-Smartsheet).

מידע נוסף על Smartsheet API זמין במאמר Smartsheet API Reference.

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

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

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

שימוש בחיבור Smartsheet בשילוב

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

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

פעולות

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

הפעולה DownloadAttachment

הפעולה הזו מורידה קובץ מצורף מגיליון.

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון.
AttachmentID String True המזהה הייחודי של הקובץ המצורף.

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

הפעולה DeleteAttachment

הפעולה הזו מוחקת קובץ מצורף שצוין מגיליון.

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון.
AttachmentID String True המזהה הייחודי של הקובץ המצורף.

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

הפעולה CopyRowsToAnotherSheet

הפעולה הזו מעתיקה שורות מגיליון אחד לגיליון אחר.

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון שממנו יועתקו השורות.
RowIds String True רשימה מופרדת בפסיקים של מזהי שורות להעתקה מהגיליון.
DestinationSheetId String True המזהה הייחודי של גיליון היעד שאליו יועתקו השורות.

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

פעולת CopySheet

הפעולה הזו מעתיקה גיליון לתיקייה, לספריית הבית או לסביבת עבודה.

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון להעתקה.
DestinationType String True סוג היעד שאליו יועתק הגיליון. הערכים האפשריים הם folder,‏ home או workspace.
DestinationId String True המזהה הייחודי של היעד שאליו תועתק הגיליון. השדה הזה נדרש כש-DestinationType הוא folder או workspace, והוא חייב להיות null כש-DestinationType הוא home.
NewName String True השם הרצוי של הגיליון שהועתק.
כולל String לא נכון רשימה מופרדת בפסיקים של רכיבים נוספים בגיליון שרוצים לכלול בפעולת ההעתקה. הערכים הקבילים הם attachments, cellLinks, data, discussions, filters, forms, ruleRecipients, rules ו-shares.

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

פעולה MoveRowsToAnotherSheet

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

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון שממנו יועברו השורות.
RowIds String True רשימה מופרדת בפסיקים של מזהי השורות להעברה מהגיליון.
DestinationSheetId String True המזהה הייחודי של גיליון היעד שאליו יועברו השורות.

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

פעולת MoveSheet

הפעולה הזו מעבירה גיליון לתיקייה, לספריית הבית או לסביבת עבודה.

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

שם הפרמטר סוג נתונים חובה תיאור
SheetId String True המזהה הייחודי של הגיליון שרוצים להעביר.
DestinationType String True סוג היעד שאליו תועבר הגיליון. הערכים האפשריים הם folder,‏ home או workspace.
DestinationId String True המזהה הייחודי של היעד שאליו הגיליון יועבר. השדה הזה נדרש כש-DestinationType הוא folder או workspace, והוא חייב להיות null כש-DestinationType הוא home.

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

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

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

דוגמה – הורדת קובץ מצורף

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה DownloadAttachment ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "SheetId": "5141926996037508",
      "AttachmentID": "1667587811610500"
    }
    
  4. אם הפעולה מצליחה, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לערך הבא:

     [
      {
        "Success": "true",
        "URL": "https://s3.amazonaws.com/SmartsheetB1/37540b4438a6466a973d678484c1fac8?response-content-disposition=attachment%3Bfilename%3D%22TestGOOGLE3.txt%22%3Bfilename*%3DUTF-8%27%27TestGOOGLE3.txt&Signature=rVHv4loce%2BrL4lYPlteTgAmkB%2Bk%3D&Expires=1744826533&AWSAccessKeyId=11950YFEZZJFSSKKB3G2",
        "Content": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
      }
    ]
    

דוגמה – מחיקת קובץ מצורף

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים פעולה DeleteAttachment ולוחצים על סיום.
  3. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "SheetId": "5141926996037508",
      "AttachmentID": "1667587811610500"
    }
    
  4. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    [
      {
        "Success": "true",
      }
    ]
    

דוגמה – העתקת שורות לגיליון אחר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים פעולה CopyRowsToAnotherSheet ולוחצים על סיום.
  3. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Default Value:
      {
      "SheetId": "7483321975000964",
      "RowIds": "7935781927128964",
      "DestinationSheetId": "7197099985686404"
    }
    
  4. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

     [
      {
      "Success": "true",
    	"AffectedRows":"1"
      }
    ]
    

דוגמה – העתקה של גיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים פעולה CopySheet ולוחצים על סיום.
  3. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "SheetId": "5141926996037508",
      "DestinationType": "workspace",
      "DestinationId": "4219254305253252",
      "NewName": "Copied sheet appears",
      "Include": "comments"
    }
    
  4. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    [
      {
        "Success": "true",
      }
    ]
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים פעולה MoveRowsToAnotherSheet ולוחצים על סיום.
  3. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "SheetId": "7483321975000964",
      "RowIds": "7935781927128964",
      "DestinationSheetId": "7197099985686404"
    }
    
  4. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    [
      {
      "Success": "true",
    	"AffectedRows":"1"
      }
    ]
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים פעולה MoveSheet ולוחצים על סיום.
  3. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Default Value:
    {
      "SheetId": "5141926996037508",
      "DestinationType": "workspace",
      "DestinationId": "4219254305253252"
    }
    
  4. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    [
      {
        "Success": "true",
      }
    ]
    

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

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

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

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

דוגמה – קבלת פרטי עמודה בגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Columns מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את entityId ל-849633317179268, שהוא המפתח שיועבר. כדי להגדיר את entityId, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "849633317179268" בשדה Input Value (ערך קלט) ובוחרים את entityId כמשתנה מקומי.
  5. צריך להעביר את הערך של entityId ישירות, למשל '849633317179268'. כאן, הערך '849633317179268' הוא הערך הייחודי של המפתח הראשי, שחייב לעבור

    במקרים מסוימים, העברת entityId עלולה להקפיץ הודעת שגיאה בגלל שני מפתחות מורכבים. במקרים כאלה, אפשר להשתמש ב-filterClause ולהעביר את הערך, למשל id='849633317179268'.

דוגמה – מחיקת שורה מגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Team_Task_List_by_Priority מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את entityId לערך 849633317179268, שהוא המפתח שיועבר. כדי להגדיר את entityId, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "849633317179268" בשדה Input Value (ערך קלט) ובוחרים את entityId כמשתנה מקומי.
  5. אם לישות יש שני מפתחות עסקיים מורכבים או מפתחות ראשיים, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-id='849633317179268'.

דוגמה – יצירת קובץ מצורף לגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Attachments מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {
      "SheetId": "5141926996037508",
      "RowId": "8196592918597508",
      "Name": "Random.txt",
      "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
    }
    

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

    {"Id": "7144235189178244" }
    

דוגמה – יצירת פרויקט בשורה עם מועדים קבועים באמצעות פריסה בסגנון תרשים גאנט

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Gantt_Project_with_Hard_Deadline מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660"}
    

דוגמה – יצירת משימה צוותית בשורה בגיליון אלקטרוני

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Team_Task_List_by_Priority מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660"}
    

דוגמה – יצירת פעילות מכירה בשורה בגיליון אלקטרוני

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Sales_Activity_Tracking_by_Rep_Month מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660"}
    

דוגמה – יצירת הזדמנות למכירה בשורה בגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Simple_Sales_Pipeline מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660" }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Report_Sales_Activity_And_Team_Objectives מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660" }
    

דוגמה – יצירת הזמנה בשורה בגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Customer_Order_Tracking_History מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "Created from googlecloud"}
    

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

    {"RowId": "7860088629366660" }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Columns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {
      "SheetId": "3315287605596036",
      "Title": "newexposedcolumn",
      "Index": 2,
      "Type": "DATE"
    }
    

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

    {
      "Id": "550917885349764"
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Folders מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {
      "ParentFolderId": "8716915511191428",
      "Name": "sub-folder-p2"
    }
    

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

    {
      "Id": "550917885349764"
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Workspaces מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {
      "Name": "new workspace (newly exposed)"
    }
    

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

    {
      "Id": "550917885349764"
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Info_Users מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {
      "FirstName": "charlie",
      "Email": "charlie@altostrat.com",
      "LastName": "c",
      "Admin": true,
      "LicensedSheetCreator": true
    }
    

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

    {
      "Id": "550917885349764"
    }
    

דוגמה – עדכון פרטי פרויקט בגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Gantt_Project_with_Hard_Deadline מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ומזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
     {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Team_Task_List_by_Priority מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ומזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Sales_Activity_Tracking_by_Rep_Month מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
     {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Simple_Sales_Pipeline מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Report_Sales_Activity_And_Team_Objectives מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

דוגמה – עדכון הזמנה בגיליון

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Sheet_Customer_Order_Tracking_History מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את entityId בקטע Data mapper של Tasks, לוחצים על entityId ואז מזינים 849633317179268 בשדה שמופיע.
  5. בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על Open Data Mapping editor (עורך) ואז מזינים ערך דומה לערך הבא בשדה Input Value:
    {"Task Name": "updated from googlecloud"}
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    {
      "RowId": null
    }
    

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

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

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