블로그: listByUser
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
승인 필요
블로그 목록을 검색합니다.
지금 사용해 보거나 예를 참조하세요.
요청
HTTP 요청
GET https://www.googleapis.com/blogger/v3/users/userId/blogs
매개변수
매개변수 이름 |
값 |
설명 |
필수 매개변수 |
userId |
string |
블로그를 가져올 사용자의 ID입니다. 단어 self 또는 사용자의 프로필 ID입니다.
|
선택적 매개변수 |
fetchUserInfo |
boolean |
응답이 블로그가 아닌 사용자별 정보가 있는 블로그 목록인지 여부입니다.
|
view |
string |
사용 가능한 값은 다음과 같습니다.
- "
ADMIN ": 관리자 수준 세부정보
- '
AUTHOR ': 작성자 수준 세부정보
- "
READER ": 관리자 수준 세부정보
|
승인
이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)
범위 |
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{
"kind": "blogger#blogList",
"items": [
blogs Resource
],
"blogUserInfos": [
blogUserInfos Resource
]
}
속성 이름 |
값 |
설명 |
참고 |
kind |
string |
이 항목의 종류입니다. 항상 blogger#blogList 입니다. |
|
items[] |
list |
이 사용자가 저작권 또는 관리자 권한을 가진 블로그 목록입니다. |
|
blogUserInfos[] |
list |
관리자 수준의 사용자별 블로그 정보 목록 |
|
예
참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.
자바
Java 클라이언트 라이브러리 사용
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-BlogListByUser-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action object.
ListByUser blogListByUserAction = blogger.blogs().listByUser("self");
// Restrict the result content to just the data we need.
blogListByUserAction.setFields("items(description,name,posts/totalItems,updated)");
// This step sends the request to the server.
BlogList blogList = blogListByUserAction.execute();
// Now we can navigate the response.
if (blogList.getItems() != null && !blogList.getItems().isEmpty()) {
int blogCount = 0;
for (Blog blog : blogList.getItems()) {
System.out.println("Blog #" + ++blogCount);
System.out.println("\tName: " + blog.getName());
System.out.println("\tDescription: " + blog.getDescription());
System.out.println("\tPost Count: " + blog.getPosts().getTotalItems());
System.out.println("\tLast Updated: " + blog.getUpdated());
}
}
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-09(UTC)
[null,null,["최종 업데이트: 2024-08-09(UTC)"],[[["\u003cp\u003eRetrieves a list of blogs for a specified user ID, requiring authorization with Blogger scopes.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering the response to include per-user information and specifying the level of detail (admin, author, or reader).\u003c/p\u003e\n"],["\u003cp\u003eProvides a response containing blog details such as name, description, post count, and last updated time.\u003c/p\u003e\n"],["\u003cp\u003eOffers client libraries and API explorer for easy integration and testing.\u003c/p\u003e\n"],["\u003cp\u003eIncludes Java code example demonstrating how to use the API to retrieve and display blog data.\u003c/p\u003e\n"]]],[],null,["# Blogs: listByUser\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of blogs.\n[Try it now](#try-it) or [see an example](#examples).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-----------------|-----------|---------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `userId` | `string` | The ID of the user whose blogs are to be fetched. Either the word `self` or the user's profile ID. |\n| **Optional parameters** |||\n| `fetchUserInfo` | `boolean` | Whether the response is a list of blogs with per-user information instead of just blogs. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Admin level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\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\": \"blogger#blogList\",\n \"items\": [\n blogs Resource\n ],\n \"blogUserInfos\": [\n blogUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|-----------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#blogList`. | |\n| `items[]` | `list` | The list of Blogs this user has Authorship or Admin rights for. | |\n| `blogUserInfos[]` | `list` | Admin level list of blog per-user information | |\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/blogger/docs/3.0/libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](http://code.google.com/p/google-api-java-client/) \n\n```java\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure the Installed App OAuth2 flow.\nCredential credential = OAuth2Native.authorize(HTTP_TRANSPORT,\n\tJSON_FACTORY, new LocalServerReceiver(),\n\tArrays.asList(BloggerScopes.BLOGGER));\n\n// Construct the Blogger API access facade object.\nBlogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)\n\t.setApplicationName(\"Blogger-BlogListByUser-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// The request action object.\nListByUser blogListByUserAction = blogger.blogs().listByUser(\"self\");\n\n// Restrict the result content to just the data we need.\nblogListByUserAction.setFields(\"items(description,name,posts/totalItems,updated)\");\n\n// This step sends the request to the server.\nBlogList blogList = blogListByUserAction.execute();\n\n// Now we can navigate the response.\nif (blogList.getItems() != null && !blogList.getItems().isEmpty()) {\n\tint blogCount = 0;\n\tfor (Blog blog : blogList.getItems()) {\n\t\tSystem.out.println(\"Blog #\" + ++blogCount);\n\t\tSystem.out.println(\"\\tName: \" + blog.getName());\n\t\tSystem.out.println(\"\\tDescription: \" + blog.getDescription());\n\t\tSystem.out.println(\"\\tPost Count: \" + blog.getPosts().getTotalItems());\n\t\tSystem.out.println(\"\\tLast Updated: \" + blog.getUpdated());\n\t}\n}\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]