Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는
새로운 API 메서드가 있습니다.
v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면
지원 중단 일정 및 안내를 검토하세요.
Method: accounts.locations.media.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eRetrieves a list of media items associated with a specific Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to handle large sets of media items, with a maximum page size of 2500.\u003c/p\u003e\n"],["\u003cp\u003eReturns details such as media item data, total item count, and a token for accessing subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, including \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"]]],["This describes retrieving a list of media items associated with a location via a `GET` request to `https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media`. The `parent` path parameter specifies the location. Optional query parameters include `pageSize` (default 100, max 2500) and `pageToken` for pagination. The response body contains an array of `mediaItems`, `totalMediaItemCount`, and `nextPageToken` for further pagination. The request body must be empty. Requires OAuth scopes: `plus.business.manage` or `business.manage`.\n"],null,["# Method: accounts.locations.media.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.ListMediaItemsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of media items associated with a location.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media`\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 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, which is also the maximum supported number of media items able to be added to a location with the Google My Business API. Maximum page size is 2500. |\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.ListMediaItems.\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. |\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 media.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)."]]
