서가: 목록
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 사용자의 공개 책갈피 리소스 목록을 가져옵니다.
지금 사용해보기
사용자 ID에 관한 자세한 내용은 Google 도서 ID 섹션을 참고하세요.
요청
HTTP 요청
GET https://www.googleapis.com/books/v1/users/userId/bookshelves
파라미터
매개변수 이름 |
값 |
설명 |
필수 매개변수 |
userId |
string |
보관함을 검색할 사용자의 ID입니다.
|
선택적 매개변수 |
source |
string |
이 요청의 작성자를 식별하는 문자열입니다.
|
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{
"kind": "books#bookshelves",
"items": [
bookshelf Resource
]
}
속성 이름 |
값 |
설명 |
참고 |
kind |
string |
리소스 유형입니다. |
|
items[] |
list |
서가 목록입니다. |
|
사용해 보기
아래 익스플로러를 사용하여 라이브 데이터에서 이 메서드를 호출하고 응답을 확인해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-08(UTC)
[null,null,["최종 업데이트: 2024-11-08(UTC)"],[[["\u003cp\u003eRetrieves a list of public bookshelves for a specific user ID.\u003c/p\u003e\n"],["\u003cp\u003eRequest requires the user ID and can optionally include the request source.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes resource type and a list of bookshelves if successful.\u003c/p\u003e\n"],["\u003cp\u003eMethod does not require a request body.\u003c/p\u003e\n"],["\u003cp\u003eUsers can try the method with live data using the provided explorer.\u003c/p\u003e\n"]]],[],null,["# Bookshelf: list\n\nRetrieves a list of public [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n[Try it now](#try-it).\n\nMore information about user IDs can be found in the section [Google Books IDs](/books/docs/v1/using#ids).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/users/userId/bookshelves\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|----------|----------------------------------------------------|\n| **Required Parameters** |||\n| `userId` | `string` | ID of user for whom to retrieve bookshelves. |\n| **Optional Parameters** |||\n| `source` | `string` | String to identify the originator of this request. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"books#bookshelves\",\n \"items\": [\n bookshelf Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|---------------|----------|------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of bookshelves. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]