דפים: רשימה

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

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

בקשה

בקשת 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': פרטים ברמת האדמין

גוף הבקשה

אין לספק גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:

{
  "kind": "blogger#pageList",
  "items": [
    pages Resource
  ]
}
שם הנכס ערך תיאור הערות
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());
}
}

נסה בעצמך!

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