Blogs: listByUser
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Requer autorização
Recupera uma lista de blogs.
Faça um teste agora ou veja um exemplo.
Solicitação
Solicitação HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs
Parâmetros
Nome do parâmetro |
Valor |
Descrição |
Parâmetros obrigatórios |
userId |
string |
O ID do usuário cujos blogs serão buscados. A palavra self ou o ID do perfil do usuário.
|
Parâmetros opcionais |
fetchUserInfo |
boolean |
Se a resposta é uma lista de blogs com informações por usuário, em vez de apenas blogs.
|
view |
string |
Os valores aceitáveis são:
- "
ADMIN ": detalhes no nível do administrador
- "
AUTHOR ": detalhes no nível do autor
- "
READER ": detalhes no nível do administrador
|
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).
Escopo |
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"kind": "blogger#blogList",
"items": [
blogs Resource
],
"blogUserInfos": [
blogUserInfos Resource
]
}
Nome da propriedade |
Valor |
Descrição |
Observações |
kind |
string |
O tipo da entidade. Sempre blogger#blogList . |
|
items[] |
list |
A lista de blogs nos quais este usuário tem direitos de Autoria ou Administrador. |
|
blogUserInfos[] |
list |
Lista no nível do administrador de informações do blog por usuário |
|
Exemplos
Observação: os exemplos de código disponíveis para esse método não representam todas as linguagens de programação compatíveis. Consulte a página de bibliotecas cliente para ver uma lista de linguagens compatíveis.
Java
Usa a biblioteca cliente de 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());
}
}
Confira!
Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-08-09 UTC.
[null,null,["Última atualização 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."]]