בלוגים: 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 בהמשך.