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)
  },
  "resourceAccessControlConfig": {
    object (ResourceAccessControlConfig)
  }
}
שדות
notebooklmConfig

object (NotebooklmConfig)

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

object (ResourceAccessControlConfig)

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

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.

ResourceAccessControlConfig

ההגדרה קובעת את אמצעי בקרת הגישה ברמת המשאב למשתמשים בגרסה הארגונית של Gemini Enterprise.

ייצוג ב-JSON 
{
  "dataStoreAccessControlEnabled": boolean
}
שדות
dataStoreAccessControlEnabled

boolean

זה שינוי אופציונלי. אם true, מאגרי הנתונים ומחברי הנתונים שמוצגים למשתמשי Gemini Enterprise מסוננים כך שיוצגו רק אלה שהמשתמש קיבל לגביהם את הרשאת ה-IAM הנדרשת ברמת המשאב .get.

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

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

Methods

get

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

patch

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

provision

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

reportConsentChange

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