Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک location جدید متعلق به حساب مشخص شده ایجاد می کند و آن را برمی گرداند.
درخواست HTTP
POST https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
parent | string نام حسابی که در آن این مکان ایجاد می شود. |
پارامترهای پرس و جو
| مولفه های |
|---|
validateOnly | boolean اگر درست باشد، درخواست بدون ایجاد مکان واقعی تأیید می شود. |
requestId | string شناسه درخواست منحصر به فرد برای سرور برای شناسایی درخواست های تکراری. ما استفاده از UUID را توصیه می کنیم. حداکثر طول 50 کاراکتر است. |
درخواست بدن
بدنه درخواست حاوی نمونه‌ای از Location است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Location است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/plus.business.manage -
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eCreates a new location owned by a specified account and returns the location data upon successful creation.\u003c/p\u003e\n"],["\u003cp\u003eThe endpoint utilizes a POST request to \u003ccode\u003ehttps://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations\u003c/code\u003e with path and query parameters for customization.\u003c/p\u003e\n"],["\u003cp\u003eRequires a request body containing a \u003ccode\u003eLocation\u003c/code\u003e object and responds with the newly created \u003ccode\u003eLocation\u003c/code\u003e object if successful.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.locations.create\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\nCreates a new [location](/my-business/reference/rest/v4/accounts.locations#Location) owned by the specified account, and returns it.\n\n### HTTP request\n\n`POST https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------|\n| `parent` | `string` The name of the account in which to create this location. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `validateOnly` | `boolean` If true, the request is validated without actually creating the location. |\n| `requestId` | `string` A unique request ID for the server to detect duplicated requests. We recommend using UUIDs. Max length is 50 characters. |\n\n### Request body\n\nThe request body contains an instance of [Location](/my-business/reference/rest/v4/accounts.locations#Location).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Location](/my-business/reference/rest/v4/accounts.locations#Location).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
