Google Business Performance API یک روش API جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند. زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
GoogleLocations API به شما امکان می‌دهد از قبل ببینید آیا یک مکان در نمایه کسب‌وکار ادعا شده است یا خیر. به این ترتیب، اگر موقعیت مکانی ادعا شده باشد، می توانید بلافاصله درخواست دسترسی به مکان را بدهید. همچنین، اگر حساب‌های تأیید شده انبوه را مدیریت می‌کنید، می‌توانید از قبل موارد مشابه را با دقت بیشتری انتخاب کنید و از ایجاد مکان‌های تکراری اجتناب کنید.
نقطه پایانی API نشانی اینترنتی را برمی‌گرداند که نشان می‌دهد آیا مکانی قبلاً ادعا شده است یا خیر. اگر ادعا شده است، همان URL به شما امکان می دهد فرآیند درخواست دسترسی را شروع کنید.
تصویر زیر نمای کلی از فرآیند به دست آوردن مالکیت یک مکان را ارائه می دهد.
شکل 1. نمودار Swimlane مالکیت مکان نمایه کسب و کار
مراحل زیر به شما امکان می دهد از GoogleLocations API استفاده کنید:
داده های مکان را از تاجر جمع آوری کنید.
با نقطه پایانی googleLocations.search تماس بگیرید. داده های مکان را در متن تماس ارائه دهید. همچنین، می‌توانید آن را در یک رشته پرس و جو ارائه کنید، مشابه آنچه کاربر در جستجو یا Maps وارد می‌کند. به عنوان مثال، "Starbucks 5th ave NYC."
API فهرستی از مکان‌ها و اطلاعات بالقوه مطابق با هر مکان، مانند locationName و آدرس را برمی‌گرداند.
مکانی را انتخاب کنید که با موقعیت مکانی شما مطابقت دارد. اگر هیچ منطبقی وجود ندارد، با accounts.locations.create تماس بگیرید و به مرحله 5 بروید.
بر اساس وضعیت requestAdminRightsUrl در پاسخ، اقدامات زیر را انجام دهید:
اگر requestAdminRightsUrl وجود داشته باشد، کاربر دیگری مالکیت فهرست را دارد. تاجر را به URL هدایت کنید تا درخواست دسترسی و مالکیت مکان موجود در نمایه کسب و کار را شروع کند.
اگر requestAdminRightsUrl وجود ندارد، با accounts.locations.create تماس بگیرید و فهرست جدیدی ایجاد کنید که بعداً تأیید می شود.
اگر فهرست‌های جدیدی را به عنوان بخشی از این فرآیند ایجاد کرده‌اید، می‌توانید از APIهای تأیید برای شروع تأیید فهرست‌ها استفاده کنید. برای اطلاعات بیشتر، به مدیریت تأیید صحت مراجعه کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed.\u003c/p\u003e\n"],["\u003cp\u003eIf a new listing is created, leverage verification APIs to complete the setup process.\u003c/p\u003e\n"],["\u003cp\u003eThis API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis.\u003c/p\u003e\n"]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"],null,["# GoogleLocations\n\nThe GoogleLocations API allows you to see in advance whether a location has been\nclaimed in Business Profile. This way, if the location has been claimed, you can immediately\nrequest access to the location. Also, if you manage bulk-verified accounts, you can more accurately\nselect potential matches in advance and avoid the creation of duplicate locations.\n\nThe API endpoint returns a URL that indicates if a location has already been claimed. If it has\nbeen claimed, the same URL allows you to start the access request process.\n\nThe following image provides an overview of the process to gain ownership of a location.\n**Figure 1.** Swimlane diagram of Business Profile location ownership\n\nThe following steps allow you to use the `GoogleLocations` API:\n\n1. Collect location data from the merchant.\n2. Call the\n [`googleLocations.search`](/my-business/reference/businessinformation/rest/v1/googleLocations)\n endpoint. Provide the location data within the body of the call. Alternatively, you can provide\n it in a query string, similar to what a user would enter in Search or Maps. For example,\n \"Starbucks 5th ave NYC.\"\n\n The API returns a list of potentially matching locations and information about each location,\n such as `locationName` and address.\n3. Select the location that matches your location. If there are no matches, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create), and skip to step 5.\n4. Based on the state of `requestAdminRightsUrl` in the response, take the following\n actions:\n\n 1. If `requestAdminRightsUrl` exists, another user has ownership of the listing. Direct the merchant to the URL to start a request for access and ownership of the existing location in Business Profile.\n 2. If `requestAdminRightsUrl` doesn't exist, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create) and create a new listing that will be verified later.\n5. If you created new listings as part of this process, you can utilize the verification APIs to begin verification of the listings. For more information, see [Manage verification](/my-business/content/manage-verification).\n\n| **Note:** The GoogleLocations API is intended to find the status of locations for which your company has a business relationship with the merchant. The use of the endpoints for the purposes of lead generation or competitive analysis is against [Google's policies](/my-business/content/policies#prohibited_practices) and will result in revocation of API access."]]
