ブログ: listByUser
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
認証が必要です
ブログのリストを取得します。
今すぐ試すまたは例を見る。
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/blogger/v3/users/userId/blogs
パラメータ
パラメータ名 |
値 |
説明 |
必須パラメータ |
userId |
string |
ブログを取得するユーザーの ID。self という単語またはユーザーのプロフィール ID。
|
オプション パラメータ |
fetchUserInfo |
boolean |
レスポンスが単なるブログではなく、ユーザーごとの情報を含むブログのリストであるかどうか。
|
view |
string |
有効な値は次のとおりです。
- 「
ADMIN 」: 管理者レベルの詳細
- 「
AUTHOR 」: 著者レベルの詳細
- 「
READER 」: 管理者レベルの詳細
|
承認
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
スコープ |
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
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 Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-08-09 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 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."]]