صفحات: فهرست

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

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

درخواست کنید

درخواست HTTP

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

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مورد نیاز
blogId string شناسه وبلاگ برای واکشی صفحات از.
پارامترهای اختیاری
fetchBodies boolean آیا برای بازیابی بدنه های صفحه.
status string

مقادیر قابل قبول عبارتند از:
  • " draft ": صفحات پیش‌نویس (منتشر نشده).
  • " imported ": صفحاتی که محتوای آنها حذف شده است
  • " live ": صفحاتی که برای عموم قابل مشاهده هستند
view string

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

درخواست بدن

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

پاسخ

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

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

نمونه ها

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

جاوا

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

// The BlogId for the http://buzz.blogger.com/ 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-PagesList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();

// The request action.
List pagesListAction = blogger.pages().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
pagesListAction.setFields("items(content,title,updated,url)");

// This step sends the request to the server.
PageList pages = pagesListAction.execute();

// Now we can navigate the response.
if (pages.getItems() != null && !pages.getItems().isEmpty()) {
for (Page page : pages.getItems()) {
System.out.println("Title: " + page.getTitle());
System.out.println("URL: " + page.getUrl());
System.out.println("Last Updated:" + page.getUpdated());
System.out.println("Content: " + page.getContent());
}
}

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

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