PostUserInfos: lista
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wymaga autoryzacji
Pobiera listę par informacji o postach i użytkownikach, które mogą być przefiltrowane. Informacje o użytkowniku dotyczące posta zawierają informacje o poszczególnych użytkownikach dotyczące tego posta, takie jak prawa dostępu.
Wypróbuj
Żądanie
Żądanie HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parametry
| Nazwa parametru |
Wartość |
Opis |
| Parametry wymagane |
blogId |
string |
Identyfikator bloga, z którego mają być pobierane posty.
|
userId |
string |
Identyfikator użytkownika, którego dotyczą pobierane informacje. Słowo „self” (bez cudzysłowów) lub identyfikator profilu użytkownika.
|
| Parametry opcjonalne |
endDate |
datetime |
Data ostatniego postu do pobrania, data i godzina w formacie RFC 3339.
|
fetchBodies |
boolean |
Określa, czy ma być uwzględniona treść posta. Wartość domyślna to false.
(wartość domyślna: false)
|
labels |
string |
Lista etykiet do wyszukania, oddzielonych przecinkami.
|
maxResults |
unsigned integer |
Maksymalna liczba postów do pobrania.
|
orderBy |
string |
kolejność sortowania stosowana w wynikach wyszukiwania; Wartość domyślna to published.
Akceptowane wartości:
- „
published”: kolejność według daty opublikowania posta.
- „
updated”: kolejność według daty ostatniej aktualizacji wpisu.
|
pageToken |
string |
token kontynuacji, który służy do przewijania dużych zbiorów wyników. Aby uzyskać następną stronę wyników, ustaw dla tego parametru wartość „nextPageToken” z poprzedniej odpowiedzi.
|
startDate |
datetime |
Najwcześniejsza data pobrania, data i godzina w formacie RFC 3339.
|
status |
string |
Akceptowane wartości:
- „
draft”: opublikowane posty
- „
live”: opublikowane posty
- „
scheduled”: posty zaplanowane do opublikowania w przyszłości.
|
view |
string |
Akceptowane wartości:
- „
ADMIN”: szczegóły na poziomie administracyjnym
- „
AUTHOR”: szczegóły na poziomie autora.
- „
READER”: szczegóły na poziomie czytelnika.
|
Autoryzacja
To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).
| Zakres |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Treść żądania
W przypadku tej metody nie podawaj treści żądania.
Odpowiedź
Jeśli operacja się powiedzie, metoda zwróci odpowiedź o tej strukturze:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
kind |
string |
Rodzaj tej encji. Zawsze blogger#postList |
|
nextPageToken |
string |
token strony do pobrania następnej strony, jeśli taka istnieje. |
|
items[] |
list |
Lista postów z informacjami o użytkowniku na blogu. |
|
Wypróbuj
Aby wywołać tę metodę na podstawie danych na żywo i zobaczyć odpowiedź, użyj narzędzia APIs Explorer.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-11-30 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]
