PostUserInfos: daftar
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memerlukan otorisasi
Mengambil daftar pasangan info pengguna dan postingan, yang mungkin difilter. Info pengguna postingan berisi informasi per pengguna tentang postingan, seperti hak akses, yang khusus untuk pengguna.
Coba sekarang.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parameter
Nama parameter |
Nilai |
Deskripsi |
Parameter yang diperlukan |
blogId |
string |
ID blog tempat mengambil postingan.
|
userId |
string |
ID pengguna untuk informasi per pengguna yang akan diambil. Kata 'self' (tanpa tanda petik) atau ID profil pengguna.
|
Parameter opsional |
endDate |
datetime |
Tanggal postingan terbaru yang akan diambil, tanggal-waktu dengan format RFC 3339.
|
fetchBodies |
boolean |
Apakah akan menyertakan konten isi postingan. Default-nya adalah false .
(Default: false )
|
labels |
string |
Daftar label yang dipisahkan koma untuk ditelusuri.
|
maxResults |
unsigned integer |
Jumlah maksimum postingan yang akan diambil.
|
orderBy |
string |
Urutan pengurutan yang diterapkan ke hasil penelusuran. Default-nya adalah published .
Nilai yang dapat diterima adalah:
- "
published ": Mengurutkan menurut tanggal postingan dipublikasikan
- "
updated ": Mengurutkan berdasarkan tanggal postingan terakhir diperbarui
|
pageToken |
string |
Token lanjutan, yang digunakan untuk mengelompokkan kumpulan hasil besar. Untuk mendapatkan halaman hasil berikutnya, tetapkan parameter ini ke nilai "nextPageToken" dari respons sebelumnya.
|
startDate |
datetime |
Tanggal postingan paling awal yang akan diambil, tanggal-waktu dengan format RFC 3339.
|
status |
string |
Nilai yang dapat diterima adalah:
- "
draft ": Draf postingan
- "
live ": Postingan yang dipublikasikan
- "
scheduled ": Postingan yang dijadwalkan untuk dipublikasikan pada masa mendatang.
|
view |
string |
Nilai yang dapat diterima adalah:
- "
ADMIN ": Detail tingkat admin
- "
AUTHOR ": Detail tingkat penulis
- "
READER ": Detail tingkat pembaca
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Isi permintaan
Jangan berikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos 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 dengan informasi Pengguna untuk postingan, untuk Blog ini. |
|
Cobalah!
Gunakan API Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-11-30 UTC.
[null,null,["Terakhir diperbarui pada 2024-11-30 UTC."],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]