Blog: listByUser
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Richiede l'autorizzazione
Recupera un elenco di blog.
Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs
Parametri
Nome del parametro |
Valore |
Descrizione |
Parametri obbligatori |
userId |
string |
L'ID dell'utente di cui recuperare i blog. La parola self o l'ID profilo dell'utente.
|
Parametri facoltativi |
fetchUserInfo |
boolean |
Se la risposta è un elenco di blog con informazioni per utente anziché solo blog.
|
view |
string |
I valori accettati sono:
- "
ADMIN ": dettaglio a livello di amministratore
- "
AUTHOR ": dettagli a livello di autore
- "
READER ": dettaglio a livello di amministratore
|
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Corpo della richiesta
Non fornire un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": "blogger#blogList",
"items": [
blogs Resource
],
"blogUserInfos": [
blogUserInfos Resource
]
}
Nome proprietà |
Valore |
Descrizione |
Note |
kind |
string |
Il tipo di questa entità. Sempre blogger#blogList . |
|
items[] |
list |
L'elenco di blog per i quali questo utente dispone dei diritti di paternità o amministratore. |
|
blogUserInfos[] |
list |
Elenco di livello amministratore di informazioni per utente del blog |
|
Esempi
Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).
Java
Utilizza la libreria client 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());
}
}
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-08-09 UTC.
[null,null,["Ultimo aggiornamento 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."]]