الصفحات: قائمة

لاسترداد قائمة الصفحات الخاصة بمدونة. جرِّب الخدمة الآن أو اطّلِع على مثال.

الترخيص مطلوب إذا كانت الصفحات متوفرة على مدوّنة خاصة. إذا كانت الصفحات على مدونة عامة، فيمكن استدعاء هذه الطريقة بدون إذن.

الطلب

طلب 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
  ]
}
اسم الموقع القيمة الوصف Notes
kind string نوع هذا الكيان. دائمًا blogger#pageList
items[] list قائمة موارد الصفحات للمدونة المحددة.

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

Java

لاستخدام مكتبة برامج Java

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

تجربة

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.