Posty: lista

Pobiera listę postów. Wypróbuj teraz lub zobacz przykład

Autoryzacja jest wymagana, jeśli posty znajdują się na prywatnym blogu. Jeśli posty znajdują się na publicznym blogu, tę metodę można wywołać 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 Data ostatniego posta do pobrania w formacie date-time RFC 3339.
fetchBodies boolean Określa, czy treść postów jest uwzględniona (domyślnie: true). Aby zminimalizować ruch, ustaw wartość „false”, gdy treść postów nie jest wymagana. (Domyślnie: true)
fetchImages boolean Czy metadane adresu URL obrazu są uwzględnione w przypadku każdego posta.
labels string Lista etykiet rozdzielona przecinkami, których chcesz wyszukać.
maxResults unsigned integer Maksymalna liczba postów do pobrania.
orderBy string Kolejność sortowania zastosowana do wyników.

Akceptowane wartości:
  • „published”: zamówienie według daty opublikowania posta
  • „updated”: sortowanie według daty ostatniej aktualizacji posta
sortOption string UNAVAILABLE NOW

Kolejność sortowania zastosowana do wyników.

Akceptowane wartości:
  • „descending”: sortuj posty w kolejności malejącej (domyślnie)
  • „ascending”: sortuj posty w kolejności rosnącej w czasie.
pageToken string Token kontynuacji, jeśli żądanie jest podzielone na strony.
startDate datetime Najwcześniejsza data publikacji do pobrania w formacie date-time RFC 3339.
status string

Akceptowane wartości:
  • „draft”: posty w wersji roboczej
  • „live”: opublikowane posty
  • „scheduled”: posty, które mają zostać opublikowane w przyszłości.
view string

Akceptowane wartości:
  • „ADMIN”: szczegóły na poziomie administratora
  • „AUTHOR”: szczegóły na poziomie autora
  • „READER”: szczegóły dotyczące poziomu czytelnika

Treść żądania

Nie podawaj treści żądania w przypadku tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "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 stronicowania do pobrania następnej strony, 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 narzędzia APIs Explorer poniżej, aby wywołać tę metodę na danych na żywo i zobaczyć odpowiedź.