REST Resource: resources.buildings
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: מבנה
ממשק API ציבורי: Resources.buildings
| ייצוג ב-JSON |
{
"buildingId": string,
"buildingName": string,
"description": string,
"coordinates": {
object (BuildingCoordinates)
},
"kind": string,
"etags": string,
"floorNames": [
string
],
"address": {
object (BuildingAddress)
}
} |
| שדות |
buildingId |
string
מזהה ייחודי של הבניין. האורך המקסימלי הוא 100 תווים.
|
buildingName |
string
שם הבניין כפי שהוא מופיע למשתמשים ביומן. חייב להיות ייחודי ללקוח. לדוגמה, 'NYC-CHEL'. האורך המקסימלי הוא 100 תווים.
|
description |
string
תיאור קצר של הבניין. לדוגמה, 'Chelsea Market'.
|
coordinates |
object (BuildingCoordinates)
הקואורדינטות הגיאוגרפיות של מרכז הבניין, שמוצגות כקו הרוחב וקו האורך בספרות עשרוניות.
|
kind |
string
סוג המשאב.
|
etags |
string
ה-ETag של המשאב.
|
floorNames[] |
string
השמות המוצגים של כל הקומות במבנה הזה. הקומות צפויות להיות ממוינות בסדר עולה, מהקומה הנמוכה ביותר לקומה הגבוהה ביותר. לדוגמה, ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] הרשימה חייבת לכלול רשומה אחת לפחות.
|
address |
object (BuildingAddress)
הכתובת הפיזית של הבניין. פרטים נוספים זמינים במאמר PostalAddress. שימו לב שצריך לציין רק שורת כתובת אחת וקוד אזור אחד.
|
BuildingCoordinates
ממשק API ציבורי: Resources.buildings
| ייצוג ב-JSON |
{
"latitude": number,
"longitude": number
} |
| שדות |
latitude |
number
קו הרוחב במעלות עשרוניות.
|
longitude |
number
קו האורך במעלות עשרוניות.
|
BuildingAddress
ממשק API ציבורי: Resources.buildings
| ייצוג ב-JSON |
{
"regionCode": string,
"languageCode": string,
"postalCode": string,
"administrativeArea": string,
"locality": string,
"sublocality": string,
"addressLines": [
string
]
} |
| שדות |
regionCode |
string
חובה. קוד האזור במאגר CLDR של המדינה או האזור של הכתובת.
|
languageCode |
string
זה שינוי אופציונלי. קוד השפה BCP-47 של התוכן בכתובת הזו (אם ידוע).
|
postalCode |
string
זה שינוי אופציונלי. המיקוד של הכתובת.
|
administrativeArea |
string
זה שינוי אופציונלי. הרמה המנהלית הגבוהה ביותר שמשמשת לכתובות דואר של מדינה או אזור.
|
locality |
string
זה שינוי אופציונלי. בדרך כלל מתייחס לחלק של העיר בכתובת. דוגמאות: עיר בארה"ב, עיר בבריטניה, יישוב בבריטניה. באזורים בעולם שבהם היישובים לא מוגדרים בצורה טובה או לא מתאימים למבנה הזה, משאירים את השדה locality ריק ומשתמשים ב-addressLines.
|
sublocality |
string
זה שינוי אופציונלי. יישוב משנה של הכתובת.
|
addressLines[] |
string
שורות כתובת לא מובנות שמתארות את הרמות הנמוכות יותר של הכתובת.
|
Methods |
|
|
מחיקת מבנה. |
|
|
אחזור של מבנה. |
|
|
הוספת בניין. |
|
|
אחזור רשימת בניינים בחשבון. |
|
|
תיקון של בניין. |
|
|
עדכון של מבנה. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-24 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-24 (שעון UTC)."],[],[],null,["# REST Resource: resources.buildings\n\nResource: Building\n------------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"buildingId\": string, \"buildingName\": string, \"description\": string, \"coordinates\": { object (/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingCoordinates) }, \"kind\": string, \"etags\": string, \"floorNames\": [ string ], \"address\": { object (/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingAddress) } } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `buildingId` | `string` Unique identifier for the building. The maximum length is 100 characters. |\n| `buildingName` | `string` The building name as seen by users in Calendar. Must be unique for the customer. For example, \"NYC-CHEL\". The maximum length is 100 characters. |\n| `description` | `string` A brief description of the building. For example, \"Chelsea Market\". |\n| `coordinates` | `object (`[BuildingCoordinates](/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingCoordinates)`)` The geographic coordinates of the center of the building, expressed as latitude and longitude in decimal degrees. |\n| `kind` | `string` Kind of resource this is. |\n| `etags` | `string` ETag of the resource. |\n| `floorNames[]` | `string` The display names for all floors in this building. The floors are expected to be sorted in ascending order, from lowest floor to highest floor. For example, \\[\"B2\", \"B1\", \"L\", \"1\", \"2\", \"2M\", \"3\", \"PH\"\\] Must contain at least one entry. |\n| `address` | `object (`[BuildingAddress](/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingAddress)`)` The postal address of the building. See [`PostalAddress`](/my-business/reference/rest/v4/PostalAddress) for details. Note that only a single address line and region code are required. |\n\nBuildingCoordinates\n-------------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"latitude\": number, \"longitude\": number } ``` |\n\n| Fields ||\n|-------------|----------------------------------------|\n| `latitude` | `number` Latitude in decimal degrees. |\n| `longitude` | `number` Longitude in decimal degrees. |\n\nBuildingAddress\n---------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"regionCode\": string, \"languageCode\": string, \"postalCode\": string, \"administrativeArea\": string, \"locality\": string, \"sublocality\": string, \"addressLines\": [ string ] } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `regionCode` | `string` Required. CLDR region code of the country/region of the address. |\n| `languageCode` | `string` Optional. BCP-47 language code of the contents of this address (if known). |\n| `postalCode` | `string` Optional. Postal code of the address. |\n| `administrativeArea` | `string` Optional. Highest administrative subdivision which is used for postal addresses of a country or region. |\n| `locality` | `string` Optional. Generally refers to the city/town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave locality empty and use addressLines. |\n| `sublocality` | `string` Optional. Sublocality of the address. |\n| `addressLines[]` | `string` Unstructured address lines describing the lower levels of an address. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-----------------------------------------------|\n| ### [delete](/workspace/admin/directory/reference/rest/v1/resources.buildings/delete) | Deletes a building. |\n| ### [get](/workspace/admin/directory/reference/rest/v1/resources.buildings/get) | Retrieves a building. |\n| ### [insert](/workspace/admin/directory/reference/rest/v1/resources.buildings/insert) | Inserts a building. |\n| ### [list](/workspace/admin/directory/reference/rest/v1/resources.buildings/list) | Retrieves a list of buildings for an account. |\n| ### [patch](/workspace/admin/directory/reference/rest/v1/resources.buildings/patch) | Patches a building. |\n| ### [update](/workspace/admin/directory/reference/rest/v1/resources.buildings/update) | Updates a building. |"]]
