پست ها: لیست

لیستی از پست ها را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

اگر پست‌ها در وبلاگی خصوصی هستند، مجوز لازم است. اگر پست ها در وبلاگی هستند که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.

درخواست کنید

درخواست 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 ترتیب مرتب سازی به نتایج اعمال می شود.

مقادیر قابل قبول عبارتند از:
  • " published ": ترتیب بر اساس تاریخ انتشار پست
  • " updated ": بر اساس تاریخ آخرین به روز رسانی پست سفارش دهید
sortOption string UNAVAILABLE NOW

مرتب سازی جهت اعمال شده به نتایج.

مقادیر قابل قبول عبارتند از:
  • " descending ": مرتب سازی پست ها به ترتیب نزولی در زمان (پیش فرض)
  • " ascending ": مرتب سازی پست ها به ترتیب صعودی در زمان
pageToken string در صورتی که درخواست صفحه شده باشد، نشانه ادامه.
startDate datetime اولین تاریخ ارسال برای واکشی، date-time با قالب بندی RFC 3339 .
status string

مقادیر قابل قبول عبارتند از:
  • " draft ": پیش نویس پست ها
  • " live ": پست های منتشر شده
  • " scheduled ": پست هایی که قرار است در آینده منتشر شوند.
view string

مقادیر قابل قبول عبارتند از:
  • " ADMIN ": جزئیات سطح مدیریت
  • " AUTHOR ": جزئیات سطح نویسنده
  • " READER ": جزئیات سطح خواننده

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
نام ملک ارزش توضیحات یادداشت ها
kind string نوع این موجودیت. همیشه blogger#postList .
nextPageToken string نشانه صفحه‌بندی برای واکشی صفحه بعدی، در صورت وجود.
items[] list لیست پست های این وبلاگ

نمونه ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه کلاینت جاوا استفاده می کند

// 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();

}

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.