PostUserInfos: elenco
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Richiede l'autorizzazione
Recupera un elenco di coppie di post e informazioni utente dei post, eventualmente filtrato. Le informazioni utente del post contengono informazioni per utente sul post, ad esempio i diritti di accesso, specifici per l'utente.
Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parametri
Nome del parametro |
Valore |
Descrizione |
Parametri obbligatori |
blogId |
string |
ID del blog da cui recuperare i post.
|
userId |
string |
ID dell'utente per le informazioni da recuperare per utente. La parola "self" (senza virgolette) o l'identificatore del profilo dell'utente.
|
Parametri facoltativi |
endDate |
datetime |
Data dell'ultimo post da recuperare, una data e un'ora nel formato RFC 3339.
|
fetchBodies |
boolean |
Indica se includere il contenuto del corpo del post. Il valore predefinito è false .
(valore predefinito: false )
|
labels |
string |
Elenco separato da virgole di etichette da cercare.
|
maxResults |
unsigned integer |
Numero massimo di post da recuperare.
|
orderBy |
string |
Ordine di ordinamento applicato ai risultati di ricerca. Il valore predefinito è published .
I valori accettati sono:
- "
published ": ordina per data di pubblicazione del post
- "
updated ": ordina per data dell'ultimo aggiornamento del post
|
pageToken |
string |
Il token di continuazione, utilizzato per sfogliare set di risultati di grandi dimensioni. Per ottenere la pagina di risultati successiva, imposta questo parametro sul valore di "nextPageToken" della risposta precedente.
|
startDate |
datetime |
Data del post più antica da recuperare, una data e un'ora nel formato RFC 3339.
|
status |
string |
I valori accettati sono:
- "
draft ": bozze dei post
- "
live ": post pubblicati
- "
scheduled ": i post la cui pubblicazione è programmata in futuro.
|
view |
string |
I valori accettati sono:
- "
ADMIN ": dettaglio a livello di amministratore
- "
AUTHOR ": dettaglio a livello di autore
- "
READER ": dettaglio a livello di lettore
|
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 specificare 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#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
Nome proprietà |
Valore |
Descrizione |
Note |
kind |
string |
Il tipo di questa entità. Sempre blogger#postList |
|
nextPageToken |
string |
Token di paginazione per recuperare la pagina successiva, se esistente. |
|
items[] |
list |
L'elenco dei post con le informazioni utente per il post, per questo blog. |
|
Prova
Utilizza l'Explorer API di seguito 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-11-30 UTC.
[null,null,["Ultimo aggiornamento 2024-11-30 UTC."],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader 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#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]