Postingan: daftar

Mengambil daftar postingan. Coba sekarang atau lihat contoh.

Otorisasi diperlukan jika postingan berada di blog yang bersifat pribadi. Jika postingan berada di blog yang bersifat publik, metode ini dapat dipanggil tanpa otorisasi.

Permintaan

Permintaan HTTP

GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Parameter

Nama parameter Nilai Deskripsi
Parameter yang diperlukan
blogId string ID blog untuk mengambil postingan.
Parameter opsional
endDate datetime Tanggal postingan terbaru untuk diambil, date-time dengan format RFC 3339.
fetchBodies boolean Apakah konten isi postingan disertakan (default: true). Ini harus ditetapkan ke false jika isi postingan tidak diperlukan, untuk membantu meminimalkan traffic. (Default: true)
fetchImages boolean Apakah metadata URL gambar untuk setiap postingan disertakan.
labels string Daftar label yang dipisahkan koma yang akan ditelusuri.
maxResults unsigned integer Jumlah maksimum postingan yang akan diambil.
orderBy string Tata urutan diterapkan ke hasil.

Nilai yang dapat diterima adalah:
  • "published": Mengurutkan berdasarkan tanggal postingan dipublikasikan
  • "updated": Urutkan berdasarkan tanggal postingan terakhir diperbarui
sortOption string UNAVAILABLE NOW

Urutkan arah diterapkan ke hasil.

Nilai yang dapat diterima adalah:
  • "descending": Urutkan postingan dalam urutan menurun dari waktu ke waktu (default)
  • "ascending": Urutkan postingan dalam urutan menaik dari waktu ke waktu
pageToken string Token kelanjutan jika permintaan sudah di-page.
startDate datetime Tanggal postingan paling awal yang akan diambil, date-time dengan format RFC 3339.
status string

Nilai yang dapat diterima adalah:
  • "draft": Draf postingan
  • "live": Postingan yang dipublikasikan
  • "scheduled": Postingan yang dijadwalkan untuk dipublikasikan di masa mendatang.
view string

Nilai yang dapat diterima adalah:
  • "ADMIN": Detail tingkat admin
  • "AUTHOR": Detail tingkat penulis
  • "READER": Detail tingkat pembaca

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Tanggapan

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nama properti Nilai Deskripsi Catatan
kind string Jenis entitas ini. Selalu blogger#postList.
nextPageToken string Token penomoran halaman untuk mengambil halaman berikutnya, jika ada.
items[] list Daftar postingan untuk blog ini.

Contoh

Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).

Java

Menggunakan library klien 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();
}

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan lihat responsnya.