لیستی از پست ها را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
اگر پستها در وبلاگی خصوصی هستند، مجوز لازم است. اگر پست ها در وبلاگی هستند که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.
درخواست کنید
درخواست HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
پارامترها
نام پارامتر | ارزش | توضیحات |
---|---|---|
پارامترهای مورد نیاز | ||
blogId | string | شناسه وبلاگ برای دریافت پست ها از آن. |
پارامترهای اختیاری | ||
endDate | datetime | آخرین تاریخ ارسال برای واکشی، date-time با قالب بندی RFC 3339 . |
fetchBodies | boolean | آیا محتوای بدنه پستها گنجانده شده است (پیشفرض: درست). برای کمک به به حداقل رساندن ترافیک، زمانی که بدنه پست مورد نیاز نیست، باید روی false تنظیم شود. (پیشفرض: true ) |
fetchImages | boolean | آیا فراداده URL تصویر برای هر پست گنجانده شده است یا خیر. |
labels | string | فهرستی از برچسبهای جدا شده با کاما برای جستجو. |
maxResults | unsigned integer | حداکثر تعداد پست برای واکشی |
orderBy | string | ترتیب مرتب سازی به نتایج اعمال می شود. مقادیر قابل قبول عبارتند از:
|
sortOption | string | UNAVAILABLE NOW مرتب سازی جهت اعمال شده به نتایج. مقادیر قابل قبول عبارتند از:
|
pageToken | string | در صورتی که درخواست صفحه شده باشد، نشانه ادامه. |
startDate | datetime | اولین تاریخ ارسال برای واکشی، date-time با قالب بندی RFC 3339 . |
status | string | مقادیر قابل قبول عبارتند از:
|
view | string | مقادیر قابل قبول عبارتند از:
|
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "kind": "blogger#postList", "nextPageToken": string, &quo}t;items": [ posts Resource ]
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
kind | string | نوع این موجودیت. همیشه blogger#postList . | |
nextPageToken | string | نشانه صفحهبندی برای واکشی صفحه بعدی، در صورت وجود. | |
items[] | list | لیست پست های این وبلاگ |
نمونه ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه کلاینت جاوا استفاده می کند
// 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();
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.