Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: accounts.locations.media.customers.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eRetrieves a paginated list of customer-contributed media items associated with a specific Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of the page size and the use of page tokens for navigating through multiple pages of results.\u003c/p\u003e\n"],["\u003cp\u003eProvides the total number of media items for the location, which may be approximate.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either the \u003ccode\u003eplus.business.manage\u003c/code\u003e or \u003ccode\u003ebusiness.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes media item details, total count, and a token for fetching subsequent pages.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.locations.media.customers.list\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 - [JSON representation](#body.ListCustomerMediaItemsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of media items associated with a location that have been contributed by customers.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media/customers`\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 location whose customer media items will be listed. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many media items to return per page. The default value is 100, the maximum supported page size is 200. |\n| `pageToken` | `string` If specified, returns the next page of media items. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Media.ListCustomerMediaItems.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"mediaItems\": [ { object (/my-business/reference/rest/v4/accounts.locations.media#MediaItem) } ], \"totalMediaItemCount\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mediaItems[]` | `object (`[MediaItem](/my-business/reference/rest/v4/accounts.locations.media#MediaItem)`)` The returned list of media items. |\n| `totalMediaItemCount` | `integer` The total number of media items for this location, irrespective of pagination. This number is approximate, particularly when there are multiple pages of results. |\n| `nextPageToken` | `string` If there are more media items than the requested page size, then this field is populated with a token to fetch the next page of media items on a subsequent call to customers.list. |\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)."]]
