Posty: lista

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:
  • published”: sortowanie według daty opublikowania posta
  • updated”: sortowanie według daty ostatniej aktualizacji posta
sortOption string UNAVAILABLE NOW

Do wyników zastosowano kierunek sortowania.

Akceptowane wartości to:
  • descending”: sortuje posty w kolejności malejącej (domyślnie).
  • ascending”: posortuj posty w kolejności rosnącej w czasie
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:
  • draft”: wersje robocze postów
  • live”: opublikowane posty
  • scheduled”: posty zaplanowane do opublikowania w przyszłości.
view string

Akceptowane wartości to:
  • ADMIN”: informacje na poziomie administratora
  • AUTHOR”: szczegółowe informacje na poziomie autora
  • READER”: szczegóły poziomu czytelnika

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ź.