Postingan: daftar

Mengambil daftar postingan. Coba sekarang atau lihat contohnya.

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

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 tempat mengambil postingan.
Parameter opsional
endDate datetime Tanggal postingan terbaru untuk diambil, date-time dengan format RFC 3339.
fetchBodies boolean Apakah isi konten postingan disertakan (default: true). Nilai 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 untuk ditelusuri.
maxResults unsigned integer Jumlah maksimum postingan yang akan diambil.
orderBy string Tata urutan yang diterapkan ke hasil.

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

Arah pengurutan yang diterapkan pada hasil.

Nilai yang dapat diterima:
  • "descending": Mengurutkan postingan dalam urutan menurun secara waktu (default)
  • "ascending": Mengurutkan postingan dengan urutan menaik
pageToken string Token lanjutan jika permintaan di-page.
startDate datetime Tanggal postingan paling awal untuk diambil, date-time dengan format RFC 3339.
status string

Nilai yang dapat diterima:
  • "draft": Postingan draf
  • "live": Postingan yang dipublikasikan
  • "scheduled": Postingan yang dijadwalkan untuk dipublikasikan pada masa mendatang.
view string

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

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Respons

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 entity 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 langsung dan melihat responsnya.