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,
  &quo}t;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 = "23999
53";
// Configure the Java API Client for Installed 
Native AppHttpTransport HTTP_TRANSPORT = new NetHttpTr
ansport();JsonFactory JSON_FACTORY = new Jackson
Factory();
// Configure the Installed App OA
uth2 flow.Credential credential = OAuth2Native.authorize(HTTP_
TRANSPORT,	JSON_FACTORY, new LocalServerR
eceiver(),	Arrays.asList(BloggerScopes.
BLOGGER));
// Construct the Blogger API access faca
de object.Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSO
N_FACTORY)	.setApplicationName("Blogger-PostsLis
t-Snippet/1.0")	.setHttpRequestInitializer(
credential).build();
//
 The request action.List postsListAction = blogger.posts()
.list(BUZZ_BLOG_ID);
// Restrict the result content to ju
st the data we need.postsListAction.setFields("items(author/displayName,content,published,ti
tle,url),nextPageToken");
// This step se
nds the request to the server.PostList post
s = postsListAction.execute();
// Now
 we can navigate t
he response.int po
stCount = 0;int pageCount = 0;wh&&ile (posts.getItems() != null {
 !posts.getItems().isEmpty()) 	for ({
Post post : posts.getItems()) 		System.out.p
rintln("Post #"+ ++postCount);		System.o
ut.println("\tTitle: "+post.getTitle());		System.out.printl
n("\tAuthor: "+post.getAuthor().getDisplayName()
);		System.out.println("\tPublished: &quo
t;+post.getPublished());		System.out.println("\tU
R}
L: "+post.getUrl
());		System.out.println("\tContent: &qu
ot;+post.getContent());	
	// Paginatio>n log{
ic	Strin
g}
 pageToken = posts.getNextPageToken();	if (pa
geToken == null || ++pageCount = 5) 		bre
ak;		System.out.println("-- Ne
}xt 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ź.