REST Resource: projects

משאב: פרויקט

מטא-נתונים והגדרות של פרויקט Google Cloud בשירות.

ייצוג JSON 
{
  "name": string,
  "createTime": string,
  "provisionCompletionTime": string,
  "serviceTermsMap": {
    string: {
      object (ServiceTerms)
    },
    ...
  },
  "customerProvidedConfig": {
    object (CustomerProvidedConfig)
  },
  "configurableBillingStatus": {
    object (ConfigurableBillingStatus)
  }
}
שדות
name

string

פלט בלבד. השם המלא של המשאב של הפרויקט, לדוגמה projects/{project}. שימו לב: כששולחים בקשות, אפשר להשתמש גם במספר הפרויקט וגם במזהה הפרויקט, אבל השרת תמיד יגיב עם מספר הפרויקט.
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".
provisionCompletionTime

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".
serviceTermsMap

map (key: string, value: object (ServiceTerms))

פלט בלבד. מפה של תנאים והגבלות. המפתח הוא id של ServiceTerms.
customerProvidedConfig

object (CustomerProvidedConfig)

זה שינוי אופציונלי. הגדרות שסופקו על ידי הלקוח.
configurableBillingStatus

object (ConfigurableBillingStatus)

פלט בלבד. הסטטוס הנוכחי של החיוב שניתן להגדרה בפרויקט.

ServiceTerms

מטא-נתונים על התנאים וההגבלות.

ייצוג JSON 
{
  "id": string,
  "version": string,
  "state": enum (State),
  "acceptTime": string,
  "declineTime": string
}
שדות
id

string

המזהה הייחודי של התנאים וההגבלות האלה. התנאים הזמינים:
version

string

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

enum (State)

האם הפרויקט אישר או דחה את תנאי השירות, או שהאישור עדיין בהמתנה.
acceptTime

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".
declineTime

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".

מדינה

ההסכם מציין את התנאים וההגבלות האלה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל של ה-enum. הערך הזה לא נמצא בשימוש בפועל.
TERMS_ACCEPTED הפרויקט אישר את התנאים וההגבלות.
TERMS_PENDING הפרויקט ממתין לבדיקה ולאישור התנאים וההגבלות.
TERMS_DECLINED הפרויקט דחה או ביטל את ההסכמה לתנאים ולהגבלות.

CustomerProvidedConfig

הגדרות שסופקו על ידי הלקוח.

ייצוג JSON 
{
  "notebooklmConfig": {
    object (NotebooklmConfig)
  }
}
שדות
notebooklmConfig

object (NotebooklmConfig)

זה שינוי אופציונלי. הגדרות של NotebookLM.

NotebooklmConfig

הגדרות ל-NotebookLM.

ייצוג JSON 
{
  "modelArmorConfig": {
    object (ModelArmorConfig)
  },
  "optOutNotebookSharing": boolean,
  "dataProtectionPolicy": {
    object (DataProtectionPolicy)
  },
  "observabilityConfig": {
    object (ObservabilityConfig)
  }
}
שדות
modelArmorConfig

object (ModelArmorConfig)

הגדרת Model Armor שתשמש לניקוי הנחיות למשתמשים ותגובות של LLM.
optOutNotebookSharing

boolean

זה שינוי אופציונלי. האם להשבית את תכונת שיתוף הנוטבוק בפרויקט. אם לא מציינים ערך, ברירת המחדל היא false.
dataProtectionPolicy

object (DataProtectionPolicy)

זה שינוי אופציונלי. מציינת את מדיניות הגנת הנתונים של NotebookLM.
observabilityConfig

object (ObservabilityConfig)

זה שינוי אופציונלי. הגדרת יכולת הצפייה ב-NotebookLM.

ModelArmorConfig

הגדרות לתבניות Model Armor שהוגדרו על ידי הלקוח, לשימוש בניקוי של הנחיות למשתמשים ותגובות של LLM.

ייצוג JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string
}
שדות
userPromptTemplate

string

זה שינוי אופציונלי. שם המשאב של תבנית Model Armor לניקוי הנחיות למשתמשים. פורמט: projects/{project}/locations/{location}/templates/{templateId} אם לא מציינים תבנית, לא יחול ניקוי על ההנחיה למשתמש.
responseTemplate

string

זה שינוי אופציונלי. שם המשאב של תבנית Model Armor לניקוי תגובות של LLM. פורמט: projects/{project}/locations/{location}/templates/{templateId} אם לא מציינים תבנית, לא יבוצע ניקוי של התגובה של ה-LLM.

DataProtectionPolicy

הגדרת מדיניות להגנה על נתונים ב-NotebookLM.

ייצוג JSON 
{
  "sensitiveDataProtectionPolicy": {
    object (SensitiveDataProtectionPolicy)
  }
}
שדות
sensitiveDataProtectionPolicy

object (SensitiveDataProtectionPolicy)

זה שינוי אופציונלי. מדיניות ההגנה על מידע אישי רגיש.

SensitiveDataProtectionPolicy

מציין מדיניות של Sensitive data Protection‏ (https://cloud.google.com/sensitive-data-protection/docs/sensitive-data-protection-overview).

ייצוג JSON 
{
  "policy": string
}
שדות
policy

string

זה שינוי אופציונלי. שם המשאב של מדיניות Sensitive Data Protection.

ConfigurableBillingStatus

מייצג את פרמטרי החיוב הניתנים להגדרה שבתוקף כרגע. הערכים האלה נגזרים מהיסטוריית המינויים של הלקוח שמאוחסנת באופן פנימי, והם משקפים את ערכי הסף שנמצאים בשימוש פעיל למטרות חיוב בזמן הקריאה לפונקציה projects.get. הערך הזה כולל את startTime של המינוי, ועשוי להיות שונה מהערכים ב-customerProvidedConfig בגלל כללי חיוב (לדוגמה, צמצום המינוי נכנס לתוקף רק בתחילת חודש חדש). אנחנו גם כוללים את סוג העדכון כדי לציין את סוג העדכון שבוצע בהגדרת החיוב שניתנת להגדרה בפעולה projects.patch.

ייצוג JSON 
{
  "effectiveSearchQpmThreshold": string,
  "effectiveIndexingCoreThreshold": string,
  "startTime": string,
  "terminateTime": string,
  "searchQpmThresholdNextUpdateTime": string,
  "indexingCoreThresholdNextUpdateTime": string,
  "updateType": enum (UpdateType),
  "agentSearchTokenSubscriptionStatuses": [
    {
      object (AgentSearchTokenSubscriptionStatus)
    }
  ]
}
שדות
effectiveSearchQpmThreshold

string (int64 format)

זה שינוי אופציונלי. סף השאילתות לדקה (QPM) שמוגדר כרגע לחיפוש. זהו ערך הסף שלפיו משווים את השימוש ב-QPM לצורך חישוב חריגה.
effectiveIndexingCoreThreshold

string (int64 format)

זה שינוי אופציונלי. הסף הנוכחי של ליבת ההוספה לאינדקס. זהו סף השימוש שמשווים אליו את השימוש ב-Indexing Core לצורך חישוב חריגה.
startTime

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".
terminateTime

string (Timestamp format)

פלט בלבד. השעה האחרונה שבה מסתיימת ההרשמה למינויי ליבה של אינדקס ושל חיפוש qpm.

הפלט שנוצר תמיד יהיה בפורמט 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".
searchQpmThresholdNextUpdateTime

string (Timestamp format)

פלט בלבד. הזמן המוקדם ביותר לעדכון הבא של סף המינוי של QPM לחיפוש. הנתון הזה מבוסס על הערך של next_update_time שמוחזר על ידי Cloud Billing Subscription V3 API. השדה הזה מאוכלס רק אם בקשה לעדכון סף המינוי של QPM בוצעה בהצלחה.

הפלט שנוצר תמיד יהיה בפורמט 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".
indexingCoreThresholdNextUpdateTime

string (Timestamp format)

פלט בלבד. המועד המוקדם ביותר לעדכון הבא של סף המינוי של ליבת יצירת האינדקס. הנתון הזה מבוסס על הערך של next_update_time שמוחזר על ידי Cloud Billing Subscription V3 API. השדה הזה מאוכלס רק אם בקשה לעדכון סף המינוי של ליבת ההוספה לאינדקס מצליחה.

הפלט שנוצר תמיד יהיה בפורמט 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".
updateType

enum (UpdateType)

פלט בלבד. סוג העדכון שבוצע בפעולה הזו. השדה הזה מאוכלס בתגובה של projects.patch.
agentSearchTokenSubscriptionStatuses[]

object (AgentSearchTokenSubscriptionStatus)

פלט בלבד. סטטוס המינוי של TPM לחיפוש באמצעות סוכנים לפי מודל.

UpdateType

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

טיפוסים בני מנייה (enum)
UPDATE_TYPE_UNSPECIFIED סוג העדכון לא צוין.
CREATE נוצר חיוב שניתן להגדרה או שהוא הופעל.
DELETE החיוב שניתן להגדרה נמחק או הושבת.
SCALE_UP המינוי הורחב (הסף עלה).
SCALE_DOWN המינוי צומצם (הספים הופחתו).

AgentSearchTokenSubscriptionStatus

סטטוס המינוי של TPM לחיפוש באמצעות סוכנים לפי מודל. רשומה אחת לכל רשומה פעילה של coreSubscription.agent_search_token_subscriptions[*] בהגדרה שסופקה על ידי הלקוח; מאוכלסת על ידי projects.patch ו-projects.get.

הסקלרים של מחזור החיים בהודעה הזו (startTime, ‏ terminateTime, ‏ updateType, ‏ tpmThresholdNextUpdateTime) הם לכל (פרויקט, modelVersion) – הם נמצאים באותה רמה של הקשר הכולל startTime / terminateTime / updateType ב-ConfigurableBillingStatus המקיף, אבל הם מוגבלים למינוי הספציפי הזה של Agent Search TPM ולא לקשר התמחור הכולל שניתן להגדרה על ידי הלקוח. רמת הפירוט הזו לכל מופע היא מכוונת: האחסון הבסיסי ב-SubV3 הוא לכל (פרויקט, modelVersion), כך שלכל מודל יש הפעלה, סיום ועדכון נדחה משלו; הצגת הנתונים האלה בתגובה מאפשרת ללקוחות לקבל את רמת הפירוט שהם צריכים כדי לנהל התחייבויות לכל מודל בנפרד. הערכים של QPM / IndexingCore שונים – האחסון שלהם הוא שורה אחת לכל (פרויקט, מיקום), ולכן מחזור החיים שלהם מיוצג רק על ידי סקלרים של קשרים מלאים ב-ConfigurableBillingStatus.

ייצוג JSON 
{
  "modelVersion": string,
  "effectiveTpmThreshold": string,
  "tpmThresholdNextUpdateTime": string,
  "startTime": string,
  "terminateTime": string,
  "updateType": enum (UpdateType)
}
שדות
modelVersion

string

פלט בלבד. גרסת המודל של Gemini שאליה מתייחס הסטטוס הזה. תואם ל-CoreSubscription.AgentSearchTokenSubscription.model_version (גרסה יציבה של מודל Gemini ממאגר גרסאות המודלים של Gemini Enterprise Agent Platform; ראו https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
effectiveTpmThreshold

string (int64 format)

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

string (Timestamp format)

פלט בלבד. הזמן המוקדם ביותר לעדכון הבא של סף המינוי ל-TPM עבור (project, modelVersion). השדה הזה מאוכלס רק אחרי עדכון מוצלח.

הפלט שנוצר תמיד יהיה בפורמט 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".
startTime

string (Timestamp format)

פלט בלבד. התאריך שבו הופעל לראשונה מינוי ה-TPM של סוכן החיפוש הזה (project, modelVersion). הערך מוגדר פעם אחת בהפעלה הראשונה של גרסת המודל הזו, והוא לא משתנה בעקבות עדכונים של סף ההמרה. אם המינוי מסתיים ואז מופעל מחדש, נרשם ערך חדש. לא מעביר את כל הקשר startTime ב-ConfigurableBillingStatus המקיף, שממשיך לייצג את ההפעלה הראשונה של הקשר הכולל של תמחור שניתן להגדרה על ידי הלקוח.

הפלט שנוצר תמיד יהיה בפורמט 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".
terminateTime

string (Timestamp format)

פלט בלבד. אם מוגדר, השעה האפקטיבית המתוזמנת שבה המינוי הזה (פרויקט, modelVersion) ל-TPM של סוכן חיפוש יסתיים. השדה הזה מאוכלס כשהלקוח מסיר את הרשומה הזו מ-coreSubscription.agent_search_token_subscriptions[*]. לא מעביר את כל היחסים terminateTime ב-ConfigurableBillingStatus המקיף, שמאוכלס רק כשכל היחסים של התמחור שניתן להגדרה על ידי הלקוח מבוטלים.

הפלט שנוצר תמיד יהיה בפורמט 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".
updateType

enum (UpdateType)

פלט בלבד. סוג העדכון האחרון למינוי הזה (project, modelVersion), כפי שבוצע על ידי הקריאה האחרונה של projects.patch. ‫UPDATE_TYPE_UNSPECIFIED מציין שהגרסה modelVersion הזו לא עודכנה על ידי הפרויקטים האחרונים.patch (הערך effectiveTpmThreshold משקף עדכון קודם). השדה whole-relationship updateType ב-ConfigurableBillingStatus שמקיף את כל השדות ממשיך לסכם את הכיוון של העדכון האחרון בכל הממשקים בפרויקט (QPM,‏ IndexingCore ו-Agent Search TPM ביחד).

Methods

get

 הפונקציה מחזירה את ה-Project.

patch

 עדכון ההגדרות שניתנות לעריכה של פרויקט Discovery Engine.

provision

 המשאב של הפרויקט יוקצה.

reportConsentChange

 עדכון תנאי השירות של הפרויקט.