MCP Tools Reference: dataform.googleapis.com

כלי: create_folder

יוצרים תיקייה חדשה של Dataform בפרויקט בענן ובמיקום נתונים ספציפיים ב-Google Cloud.

התיקיות מארגנות את מאגרי Dataform בהיררכיה. יצירת תיקייה לא מעבירה אליה מאגרי מידע. כדי למקם מאגר בתוך תיקייה, צריך להגדיר את ערך הפרמטר containing_folder כשמשתמשים בכלי create_repository.

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

ערך הפרמטר parent צריך להיות בפורמט projects/{project_id}/locations/{location}.

צריך לציין את ערך הפרמטר folder.display_name, והוא מציין את השם הידידותי למשתמש של התיקייה.

בדוגמת הקוד הבאה מוצג שימוש בפקודה curl כדי להפעיל את הכלי create_folder MCP.

בקשת Curl 
curl --location 'https://dataform.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_folder",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

CreateFolder הזמנה לצ'אט.

CreateFolderRequest

ייצוג JSON 
{
  "parent": string,
  "folder": {
    object (Folder)
  },
  "folderId": string
}
שדות
parent

string

חובה. המיקום שבו רוצים ליצור את התיקייה. חייב להיות בפורמט projects/*/locations/*.
folder

object (Folder)

חובה. התיקייה שרוצים ליצור.
folderId
(deprecated)

string

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

תיקייה

ייצוג JSON 
{
  "name": string,
  "displayName": string,
  "containingFolder": string,
  "teamFolderName": string,
  "createTime": string,
  "updateTime": string,

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.

  // Union field _creator_iam_principal can be only one of the following:
  "creatorIamPrincipal": string
  // End of list of possible types for union field _creator_iam_principal.
}
שדות
name

string

מזהה. שם התיקייה.
displayName

string

חובה. השם הידידותי למשתמש של התיקייה.
containingFolder

string

זה שינוי אופציונלי. שם המשאב של התיקייה שמכילה את הקובץ. הפורמט צריך להיות: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, או פשוט "" אם זו תיקיית הבסיס. אפשר לעדכן את השדה הזה רק באמצעות MoveFolder.
teamFolderName

string

פלט בלבד. שם המשאב של תיקיית הצוות שהתיקייה הזו משויכת אליה. הפורמט צריך להיות: projects/{project}/locations/{location}/teamFolders/{teamFolder}. אם לא מגדירים את ההגדרה הזו, התיקייה לא משויכת לתיקייה קבוצתית והיא תיקיית משתמש.
createTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

שדה איחוד _internal_metadata.

הערך _internal_metadata יכול להיות רק אחד מהבאים:
internalMetadata

string

פלט בלבד. כל פרטי המטא-נתונים שמשמשים באופן פנימי להצגת המשאב. לדוגמה: חותמות זמן, דגלים, שדות סטטוס וכו'. הפורמט של השדה הזה הוא מחרוזת JSON.

שדה איחוד _creator_iam_principal.

הערך _creator_iam_principal יכול להיות רק אחד מהבאים:
creatorIamPrincipal

string

פלט בלבד. מזהה החשבון הראשי ב-IAM של יוצר התיקייה.

חותמת הזמן

ייצוג JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-‎253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

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

סכימת הפלט

מייצג תיקייה ב-Dataform. זהו משאב שמשמש לארגון קבצים ותיקיות אחרות, ומספק בקרת גישה היררכית.

תיקייה

ייצוג JSON 
{
  "name": string,
  "displayName": string,
  "containingFolder": string,
  "teamFolderName": string,
  "createTime": string,
  "updateTime": string,

  // Union field _internal_metadata can be only one of the following:
  "internalMetadata": string
  // End of list of possible types for union field _internal_metadata.

  // Union field _creator_iam_principal can be only one of the following:
  "creatorIamPrincipal": string
  // End of list of possible types for union field _creator_iam_principal.
}
שדות
name

string

מזהה. שם התיקייה.
displayName

string

חובה. השם הידידותי למשתמש של התיקייה.
containingFolder

string

זה שינוי אופציונלי. שם המשאב של התיקייה שמכילה את הקובץ. הפורמט צריך להיות: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, או פשוט "" אם זו תיקיית הבסיס. אפשר לעדכן את השדה הזה רק באמצעות MoveFolder.
teamFolderName

string

פלט בלבד. שם המשאב של תיקיית הצוות שהתיקייה הזו משויכת אליה. הפורמט צריך להיות: projects/{project}/locations/{location}/teamFolders/{teamFolder}. אם לא מגדירים את ההגדרה הזו, התיקייה לא משויכת לתיקייה קבוצתית והיא תיקיית משתמש.
createTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

שדה איחוד _internal_metadata.

הערך _internal_metadata יכול להיות רק אחד מהבאים:
internalMetadata

string

פלט בלבד. כל פרטי המטא-נתונים שמשמשים באופן פנימי להצגת המשאב. לדוגמה: חותמות זמן, דגלים, שדות סטטוס וכו'. הפורמט של השדה הזה הוא מחרוזת JSON.

שדה איחוד _creator_iam_principal.

הערך _creator_iam_principal יכול להיות רק אחד מהבאים:
creatorIamPrincipal

string

פלט בלבד. מזהה החשבון הראשי ב-IAM של יוצר התיקייה.

חותמת הזמן

ייצוג JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-‎253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

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

הערות על כלים

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

בנוסף למחרוזת הכותרת, מוגדרים הרמזים הבוליאניים הבאים:

  • ‫readOnlyHint: אם הערך הוא true, הכלי לא משנה את הסביבה שלו. ברירת מחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא false, הכלי יכול לבצע רק פעולות של הוספה. ברירת מחדל: true.
  • ‫idempotentHint: אם הערך הוא true, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת מחדל: false.
  • ‫openWorldHint: אם הערך הוא true, הכלי יכול ליצור אינטראקציה עם 'עולם פתוח' של ישויות חיצוניות. אם הערך הוא false, הכלי יכול ליצור אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי לחיפוש באינטרנט יהיה עולם פתוח, אבל כלי לזיכרון לא יהיה עולם פתוח.

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌