זה שינוי אופציונלי. מזהה. שם המשאב הייחודי של סוכן. פורמט: "projects/{project}/locations/{location}/dataAgents/{dataAgentId}" {dataAgent} הוא מזהה המשאב, והוא צריך להיות באורך של 63 תווים לכל היותר, ותואמת לפורמט שמתואר בכתובת https://google.aip.dev/122#resource-id-segments
זה שינוי אופציונלי. מסכת השדות משמשת לציון השדות שעליהם יתבצע כתיבה מחדש במשאב DataAgent על ידי העדכון. השדות שצוינו ב-updateMask הם יחסיים למשאב, ולא לבקשה המלאה. שדה ייכתב מחדש אם הוא נמצא במסכה. אם המשתמש לא יספק מסכה, כל השדות בבקשה עם ערכים שאינם ברירת המחדל יימחקו. אם מציינים מסכה של תו כללי, כל השדות יימחקו.
זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
requestId
string
זה שינוי אופציונלי. מזהה בקשה אופציונלי לזיהוי בקשות. עליכם לציין מזהה בקשה ייחודי כדי שאם תצטרכו לנסות שוב את הבקשה, השרת ידע להתעלם מהבקשה אם היא כבר הושלמה. השרת יבטיח זאת למשך 60 דקות לפחות ממועד הבקשה הראשונה.
לדוגמה, נניח ששלחתם בקשה ראשונית והזמן הקצוב לבקשה חלף. אם שולחים את הבקשה שוב עם אותו מזהה בקשה, השרת יכול לבדוק אם התקבלה הפעולה המקורית עם אותו מזהה בקשה, ואם כן, הוא יתעלם מהבקשה השנייה. כך הלקוחות לא ייצרו בטעות התחייבויות כפולות.
מזהה הבקשה חייב להיות מזהה UUID תקין, למעט מזהה UUID של אפס (00000000-0000-0000-0000-000000000000).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["התוכן קשה להבנה","hardToUnderstand","thumb-down"],["שגיאות בקוד לדוגמה או במידע","incorrectInformationOrSampleCode","thumb-down"],["חסרים לי פרטים או דוגמאות","missingTheInformationSamplesINeed","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-06-11 (שעון UTC)."],[],[],null,["# Method: projects.locations.dataAgents.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nUpdates the parameters of a single DataAgent.\n\n### HTTP request\n\n`PATCH https://geminidataanalytics.googleapis.com/v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [DataAgent](/gemini/docs/conversational-analytics-api/reference/rest/v1alpha/projects.locations.dataAgents#DataAgent).\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/gemini/docs/conversational-analytics-api/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `geminidataanalytics.dataAgents.update`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
