בלוגים: listByUser

נדרשת הרשאה

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

בקשה

בקשת HTTP

GET https://www.googleapis.com/blogger/v3/users/userId/blogs

פרמטרים

שם הפרמטר	ערך	תיאור
פרמטרים נדרשים
userId	string	המזהה של המשתמש שאת הבלוגים שלו רוצים לאחזר. המילה self או מזהה הפרופיל של המשתמש.
פרמטרים אופציונליים
fetchUserInfo	boolean	האם התגובה היא רשימת בלוגים עם מידע לכל משתמש ולא רק בלוגים.
view	string	הערכים הקבילים הם: "ADMIN": פרטים ברמת האדמין "AUTHOR": פרטים ברמת המחבר "READER": פרטים ברמת האדמין

אישור

הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

גוף הבקשה

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

תשובה

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

{
  "kind": "blogger#blogList",
  "items": [
    blogs Resource
  ],
  "blogUserInfos": [
    blogUserInfos Resource
  ]
}

שם הנכס	ערך	תיאור	הערות
kind	string	סוג הישות הזו. תמיד blogger#blogList.
items[]	list	רשימת הבלוגים שלמשתמש הזה יש הרשאות כתיבה או אדמין בהם.
blogUserInfos[]	list	רשימת בלוג לכל משתמש ברמת אדמין

דוגמאות

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

Java

משתמש בספריית הלקוח של Java

// 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-BlogListByUser-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action object.
ListByUser blogListByUserAction = blogger.blogs().listByUser("self");

// Restrict the result content to just the data we need.
blogListByUserAction.setFields("items(description,name,posts/totalItems,updated)");

// This step sends the request to the server.
BlogList blogList = blogListByUserAction.execute();

// Now we can navigate the response.
if (blogList.getItems() != null && !blogList.getItems().isEmpty()) {
	int blogCount = 0;
	for (Blog blog : blogList.getItems()) {
		System.out.println("Blog #" + ++blogCount);
		System.out.println("\tName: " + blog.getName());
		System.out.println("\tDescription: " + blog.getDescription());
		System.out.println("\tPost Count: " + blog.getPosts().getTotalItems());
		System.out.println("\tLast Updated: " + blog.getUpdated());
	}
}

נסה בעצמך!

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