Pobiera listę postów. Wypróbuj lub zobacz przykład.
Autoryzacja jest wymagana, jeśli posty znajdują się na prywatnym blogu. Jeśli posty znajdują się na publicznym blogu, ta metoda może zostać wywołana bez autoryzacji.
Żądanie
Żądanie HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry wymagane | ||
blogId |
string |
Identyfikator bloga, z którego mają być pobierane posty. |
Parametry opcjonalne | ||
endDate |
datetime |
Najpóźniejsza data pobrania do pobrania, w formacie date-time z formatowaniem RFC 3339.
|
fetchBodies |
boolean |
Określa, czy treść postów ma być dołączana (domyślnie: true). Jeśli treść posta nie jest wymagana, ustaw wartość false (fałsz). Ułatwi to zminimalizowanie ruchu.
(Domyślnie: true )
|
fetchImages |
boolean |
Określa, czy dołączane są metadane adresu URL obrazu w każdym poście. |
labels |
string |
Rozdzielona przecinkami lista etykiet do wyszukania. |
maxResults |
unsigned integer |
Maksymalna liczba postów do pobrania. |
orderBy |
string |
Kolejność sortowania została zastosowana do wyników.
Akceptowane wartości to:
|
sortOption |
string |
UNAVAILABLE NOW
Do wyników zastosowano kierunek sortowania. Akceptowane wartości to:
|
pageToken |
string |
Token kontynuacji, jeśli żądanie jest kierowane na stronę. |
startDate |
datetime |
Najwcześniejsza data posta do pobrania: date-time z formatowaniem RFC 3339.
|
status |
string |
Akceptowane wartości to:
|
view |
string |
Akceptowane wartości to:
|
Treść żądania
Nie podawaj treści żądania przy użyciu tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{ "kind": "blogger#postList", "nextPageToken": string, "items": [ posts Resource ] }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Rodzaj tego elementu. Zawsze blogger#postList . |
|
nextPageToken |
string |
Token podziału na strony pozwalający pobrać następną stronę, jeśli taka istnieje. | |
items[] |
list |
Lista postów na tym blogu. |
Przykłady
Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.
Java
korzysta z biblioteki klienta Java,
// The BlogId for the Blogger Buzz blog String BUZZ_BLOG_ID = "2399953";
// 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-PostsList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");
// This step sends the request to the server.
PostList posts = postsListAction.execute();
// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
for (Post post : posts.getItems()) {
System.out.println("Post #"+ ++postCount);
System.out.println("\tTitle: "+post.getTitle());
System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
System.out.println("\tPublished: "+post.getPublished());
System.out.println("\tURL: "+post.getUrl());
System.out.println("\tContent: "+post.getContent());
}
// Pagination logic
String pageToken = posts.getNextPageToken();
if (pageToken == null || ++pageCount >= 5) {
break;
}
System.out.println("-- Next page of posts");
postsListAction.setPageToken(pageToken);
posts = postsListAction.execute();
}
Wypróbuj
Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.