Posty: lista

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

Wymagana jest autoryzacja, jeśli posty są na blogu prywatnym. Jeśli posty są na blogu publicznym, można wywołać tę metodę 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 będą pobierane posty.
Parametry opcjonalne
endDate datetime Data ostatniego pobrania (date-time). Format: RFC 3339.
fetchBodies boolean Określa, czy treść postów jest uwzględniona (domyślnie: prawda). Ustaw tę wartość na „false”, gdy treść posta nie jest wymagana, aby zminimalizować ruch. (domyślnie: true)
fetchImages boolean Uwzględniane są metadane adresu URL obrazu dla każdego posta.
labels string Rozdzielona przecinkami lista etykiet do wyszukania.
maxResults unsigned integer Maksymalna liczba postów do pobrania.
orderBy string Kolejność sortowania zastosowana do wyników.

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

Kierunek sortowania zastosowany do wyników.

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

Akceptowane wartości:
  • „draft”: wersje robocze postów
  • „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 na poziomie czytelnika;

Treść żądania

Nie udostępniaj treści żądania tą metodą.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nazwa właściwości Wartość Opis Uwagi
kind string Rodzaj tej encji. Zawsze blogger#postList.
nextPageToken string Tokeny dla stron, aby pobrać następną stronę (jeśli 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

Używa biblioteki klienta w języku 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

Skorzystaj z eksploratora interfejsów API poniżej, aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź.