Method: resources.buildings.insert
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/buildings
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
customer |
string
المعرّف الفريد لحساب العميل على Google Workspace. بصفتك مشرف حساب، يمكنك أيضًا استخدام الاسم المعرِّف my_customer لتمثيل رقم تعريف العميل لحسابك.
|
مَعلمات طلب البحث
| المعلمات |
coordinatesSource |
enum (CoordinatesSource)
المصدر الذي يتم من خلاله الحصول على Building.coordinates
|
نص الطلب
يحتوي نص الطلب على مثال Building.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من Building.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://apps-apis.google.com/a/feeds/calendar/resource/
https://www.googleapis.com/auth/admin.directory.resource.calendar
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
CoordinatesSource
| عمليات التعداد |
CLIENT_SPECIFIED |
يتم ضبط Building.coordinates على الإحداثيات المضمّنة في الطلب. |
RESOLVED_FROM_ADDRESS |
تتم تعبئة Building.coordinates تلقائيًا استنادًا إلى العنوان البريدي. |
SOURCE_UNSPECIFIED |
يتم ضبط القيمة تلقائيًا على RESOLVED_FROM_ADDRESS في حال توفّر عنوان بريدي. بخلاف ذلك، يتم ضبط القيمة التلقائية على CLIENT_SPECIFIED في حال توفّر الإحداثيات. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: resources.buildings.insert\n\nInserts a building.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/buildings`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's customer ID. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `coordinatesSource` | `enum (`[CoordinatesSource](/workspace/admin/directory/reference/rest/v1/resources.buildings/insert#CoordinatesSource)`)` Source from which Building.coordinates are derived. |\n\n### Request body\n\nThe request body contains an instance of [Building](/workspace/admin/directory/reference/rest/v1/resources.buildings#Building).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Building](/workspace/admin/directory/reference/rest/v1/resources.buildings#Building).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://apps-apis.google.com/a/feeds/calendar/resource/`\n- `\n https://www.googleapis.com/auth/admin.directory.resource.calendar`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nCoordinatesSource\n-----------------\n\n| Enums ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `CLIENT_SPECIFIED` | Building.coordinates are set to the coordinates included in the request. |\n| `RESOLVED_FROM_ADDRESS` | Building.coordinates are automatically populated based on the postal address. |\n| `SOURCE_UNSPECIFIED` | Defaults to `RESOLVED_FROM_ADDRESS` if postal address is provided. Otherwise, defaults to `CLIENT_SPECIFIED` if coordinates are provided. |"]]
