Google Business Performance API 的新 API 方法可通过单个 API 请求提取多个 `DailyMetrics`。 请查看弃用时间表和相关说明，并从 v4 reportInsights API 方法迁移至 Google Business Profile Performance API。
[null,null,["最后更新时间 (UTC)：2025-08-29。"],[[["\u003cp\u003eThe Business Profile APIs allow you to build platforms for merchants to manage their Google Business Profiles, including claiming locations and providing accurate address data.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the APIs, you need to register your application and obtain OAuth 2.0 credentials.\u003c/p\u003e\n"],["\u003cp\u003eAddress and geolocation data can be managed using both Business Profile APIs and Google Maps APIs to refine location accuracy.\u003c/p\u003e\n"],["\u003cp\u003eWhen search results yield multiple or partial matches, manual refinement or selection might be necessary to ensure accuracy.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can manually adjust geolocation data using latitude and longitude coordinates to improve listing precision.\u003c/p\u003e\n"]]],[],null,["# Search for matching listings\n\n\u003cbr /\u003e\n\nWith the Business Profile APIs, you can create a platform for your merchants to\nmanage their business on Google. On your platform, you can allow your partners\nto search for listings that match their business's name, address, and phone\ndata. They can establish ownership of a location, as well as accurately place\nthe business's physical location by latitude and longitude.\n\nBefore you begin\n----------------\n\nBefore you use the Business Profile APIs, you need to register your application\nand obtain OAuth 2.0 credentials. For details on how to get started with the\nBusiness Profile APIs, see [Basic setup](/my-business/content/basic-setup).\n\nHow to work with address data\n-----------------------------\n\nTo work with address and geolocation data on your platform, you may use two\ndifferent sets of APIs and resources: the Business Profile APIs and the Maps\nAPI.\n\n### Commonly used Business Profile resources\n\nThe [`GoogleLocations`](/my-business/content/googlelocations-api-guide) API lets\nthe merchant see in advance if a location has already been claimed in\nBusiness Profile. If not, it allows the merchant to immediately request\naccess to it.\n\nThe [`PostalAddress`](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PostalAddress) object\nrepresents the physical address of a business.\n\n### Commonly used Google Maps resources\n\nThe [Maps JavaScript Places Widgets](/maps/documentation/javascript/reference/places-widget)\nare commonly used in partner workflows to create an interactive map. In\naddition, the following Maps APIs are also useful:\n\n- Return place predictions with [Place Autocomplete](/places/web-service/autocomplete) and [Place Details](/places/web-service/details). For pricing details, see [SKU: Autocomplete (included with Places Details) -- Per Session](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#ac-with-details-session).\n- Query for place information with [Place Search](/places/web-service/search). For pricing details, see [SKU: Find Place](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#find-place).\n- Provide geocoding and reverse geocoding of addresses with [Geocoding](/maps/documentation/geocoding/start). For pricing details, see [SKU: Geocoding](/maps/billing/understanding-cost-of-use?__utma=236542612.573697022.1545861194.1545861265.1545861265.1&__utmb=236542612.0.10.1545861265&__utmc=236542612&__utmx=-&__utmz=236542612.1545861265.1.1.utmcsr=(direct)%7Cutmccn=(direct)%7Cutmcmd=(none)&__utmv=-&__utmk=91275353&_ga=2.77608016.-573697022.1545861194#geocoding).\n\nOne or zero matches\n-------------------\n\nWhen a partner searches for matching listings for a location, their goal is to\nnarrow their search results to one or zero matches. This means the location\neither fits their search criteria or doesn't yet exist in Business Profile,\nrespectively.\n\nWhere there are one or zero matches, use the\n[`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create)\nmethod to create a new listing, or follow the\n[`GoogleLocations`](/my-business/content/googlelocations-api-guide) guide to\nclaim ownership of the existing listing. If Google is unable to geocode the\naddress, the location creation fails and the API response includes a request for\n`LatLng` data. For information on how the merchant can provide their `LatLng`\ndata, see\n[Manual adjustment of geolocation data](/my-business/content/search-matching-listings#adjustment-geolocation-data).\n\nOnce the `LatLng` coordinates are determined, the new listing is created.\n\nPartial and multiple matches\n----------------------------\n\nWhen a business owner or the partner's operations team searches for listings\nthat match a location, the information they type might result in only a partial\nmatch, or they might receive multiple matches to their search query. To narrow\nthe search results down to one or zero matches, partial and multiple matches are\nmanually resolved by two Maps API use cases.\n\n### User refines their search\n\nWhen a user of the partner platform searches for a location and is faced with\nmultiple partial matches, they can resolve the issue in one of the following\nways:\n\n- Analyze the partial matching addresses and select the correct one.\n- Edit or retype parts of the address to be more accurate and narrow their results to one or zero matches.\n\nA user is confronted with several partial matches in response to their address search.\n\n### User selects from one or more full matches\n\nIn some cases, multiple locations might fully match the user's search address.\nFor instance, a user might enter the following address into a partner platform:\n\n`Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia`\n\nSuppose the following responses are returned, all of which match the address\ngiven:\n\n- Kasperson Printer Center, an unverified location.\n- Bengo Seguro, a verified location.\n- Garush Productions, an unverified location.\n\nThe user needs to manually select the matching business. To ensure consumers are\nprovided with accurate directions to the business, the latitude and longitude\n(`LatLng`) data for these locations might need to be adjusted to provide higher\naccuracy. For information on how users can enter their `LatLng` manually, see\n[Manual adjustment of geolocation data](/my-business/content/search-matching-listings#adjustment-geolocation-data).\n\nManual adjustment of geolocation data\n-------------------------------------\n\nBusinesses can add the latitude and longitude (`LatLng`) coordinates of their\nbusiness to increase the accuracy of their listing on Business Profile. New\nbusinesses might not know their `LatLng` coordinates, so they can instead\nmanually drop a pin with the\n[Maps JavaScript Places Widget](/maps/documentation/javascript/reference/places-widget)\nto establish accurate `LatLng` coordinates.\nA single address resolves to three locations 1,500 feet apart. To accurately associate the business address with its `LatLng` coordinates, manual adjustment of each location's coordinates is needed.\n\nQuality of search results\n-------------------------\n\nSearch results vary widely based on the accuracy of the address that is searched\nfor and by geographic region. Developing regions often show fewer Maps places\nand inconsistent compliance with Google address formats. This leads to\nlower-quality search results and an increased need for manual address formatting\nand Maps API use."]]
