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