דפים: רשימה

אחזור הרשימה של הדפים של בלוג. אפשר לנסות עכשיו או לראות דוגמה.

נדרשת הרשאה אם הדפים נמצאים בבלוג פרטי. אם הדפים נמצאים בבלוג ציבורי, ניתן לקרוא לשיטה הזו ללא הרשאה.

בקשה

בקשת 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 הרשימה של משאבי Pages עבור הבלוג שצוין.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

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

נסה בעצמך!

אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.