ה-API של Blogger מאפשר לשלב תוכן של Blogger עם האפליקציה שלך באמצעות ממשקי API של REST. לפני שמתחילים, צריך להגדיר הרשאה.
מבוא
המסמך הזה מיועד למפתחים שרוצים לכתוב אפליקציות שיכולות לבצע אינטראקציה עם ה-API של Blogger. Blogger הוא כלי ליצירת אתרים שמאפשרים לאנשים לפרסם את מחשבותיהם על בסיס מתמשך.
אם אתם לא מכירים את המושגים של Blogger, מומלץ לקרוא את המאמר תחילת העבודה לפני שמתחילים לקוד.
מתן הרשאה וזיהוי הבקשה שלך
כל בקשה שהאפליקציה שולחת ל-Blogger APIs צריכה לזהות את האפליקציה שלך ב-Google. יש שתי דרכים לזהות את האפליקציה שלכם: באמצעות אסימון OAuth 2.0 (שמאשר גם את הבקשה), ו/או באמצעות מפתח API של האפליקציה. כך קובעים באילו מהאפשרויות להשתמש:
- אם הבקשה מחייבת הרשאה (למשל, בקשה לנתונים פרטיים של אדם), האפליקציה חייבת לספק את אסימון OAuth 2.0 עם הבקשה. גם האפליקציה יכולה לספק את מפתח ה-API, אבל היא לא חייבת לעשות זאת.
- אם לבקשה לא נדרשת הרשאה (למשל, בקשה לנתונים ציבוריים), האפליקציה חייבת לספק את מפתח ה-API או את אסימון OAuth 2.0, או את שניהם – האפשרות המתאימה לך ביותר.
הסבר על פרוטוקולים של הרשאות
כדי לאשר בקשות, האפליקציה חייבת להשתמש בפרוטוקול OAuth 2.0. אין תמיכה בפרוטוקולים אחרים של הרשאות. אם האפליקציה שלכם משתמשת באפשרות כניסה באמצעות חשבון Google, היבטים מסוימים של ההרשאה יטופלו עבורכם.
הרשאת בקשות עם פרוטוקול OAuth 2.0
משתמש מאומת צריך לקבל בקשות מה-APIs של Blogger לקבלת מידע שאינו ציבורי.
התהליך הזה מתבצע בעזרת מספר לקוח של OAuth.
קבלת מזהה לקוח של OAuthאפשר גם ליצור חשבון בדף פרטי הכניסה.
הפרטים או ה"זרימה" של תהליך ההרשאה עם OAuth 2.0 עשויים להשתנות מעט, בהתאם לסוג האפליקציה שאתם מפתחים. התהליך הכללי הבא חל על כל סוגי האפליקציות:
- כשהאפליקציה צריכה גישה לנתונים של משתמשים, היא מעבירה ל-Google בקשת גישה בהיקף ספציפי.
- Google מציגה למשתמש מסך הסכמה ומבקשת לאשר לאפליקציה לשלוח בקשה לחלק מהנתונים שלו.
- אם המשתמש מסכים, האפליקציה מקבלת מ-Google אסימון גישה לטווח קצר.
- האפליקציה מבקשת את נתוני המשתמש ומצרפת לבקשה את אסימון הגישה.
- אם Google תקבע שהבקשה והאסימון תקפים, היא תחזיר את הנתונים המבוקשים.
חלק מתהליכי העבודה כוללים שלבים נוספים, כמו שימוש באסימוני רענון כדי לקבל אסימוני גישה חדשים. למידע מפורט על תהליכי העבודה לסוגים שונים של אפליקציות, ניתן לעיין בתיעוד של OAuth 2.0 של Google.
אלה פרטי ההיקף של OAuth 2.0 לממשקי ה-API של Blogger:
https://www.googleapis.com/auth/blogger
כדי לבקש גישה באמצעות פרוטוקול OAuth 2.0, האפליקציה שלכם זקוקה למידע על ההיקף ולמידע ש-Google מספקת בזמן רישום האפליקציה (כמו מזהה לקוח וסוד לקוח).
טיפ: ספריות הלקוח של Google APIs יכולות לטפל בחלק מתהליך ההרשאה עבורכם. הן זמינות למגוון שפות תכנות. מידע נוסף זמין בדף עם ספריות ודוגמאות.
רכישה של מפתח API ושימוש בו
בקשות לממשקי API של Blogger לקבלת מידע ציבורי חייבות להיות משויכות למזהה, שיכול להיות מפתח API או אסימון גישה.
מקבלים מפתחאפשר גם ליצור חשבון בדף פרטי הכניסה.
אחרי שמקבלים מפתח API, האפליקציה יכולה לצרף את פרמטר השאילתה
key=yourAPIKey
לכל כתובות ה-URL של הבקשות.
מפתח ה-API בטוח להטמעה בכתובות URL. אין צורך בקידוד כלשהו.
עבודה עם בלוגים
אחזור בלוג
ניתן לאחזר מידע על בלוג מסוים על ידי שליחת בקשת HTTP
GET
ל-URI של הבלוג. ה-URI של הבלוג הוא בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY
אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ונתוני הבלוג:
{ "kind": "blogger#blog", "id": "2399953", "name": "Blogger Buzz", "description": "The Official Buzz from Blogger at Google", "published": "2007-04-23T22:17:29.261Z", "updated": "2011-08-02T06:01:15.941Z", "url": "http://buzz.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953", "posts": { "totalItems": 494, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts" }, "pages": { "totalItems": 2, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages" }, "locale": { "language": "en", "country": "", "variant": "" } }
אחזור בלוג לפי כתובת ה-URL שלו
כדי לאחזר בלוג באמצעות כתובת ה-URL שלו, אפשר לשלוח בקשת HTTP GET
ל-URI הבא עם פרמטר url
:
https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url
שליחת בקשה
https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והייצוג המלא של הבלוג שזוהה:
{ "kind": "blogger#blog", "id": "3213900", "name": "Blogger Developers Network", "description": "The official Blogger Developers Network weblog.", "published": "2007-02-09T10:13:10-08:00", "updated": "2012-04-15T19:38:01-07:00", "url": "http://code.blogger.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900", "posts": { "totalItems": 55, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages" }, "locale": { "language": "en", "country": "US", "variant": "" } }
אחזור בלוגים של משתמש
ניתן לאחזר רשימה של בלוגים של משתמש על ידי שליחת בקשת HTTP GET
לכתובת ה-URI של איסוף הבלוג:
https://www.googleapis.com/blogger/v3/users/userId/blogs
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */
הערה: יש לאמת את המשתמש כדי לפרסם את הבלוגים שלו, כך שעליכם לספק את כותרת ה-HTTP Authorization
עם בקשת GET
.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס 200 OK
וייצוג מלא של רשימת הבלוגים של המשתמש.
{ "kind": "blogger#blogList", "items": [ { "kind": "blogger#blog", "id": "4967929378133675647", "name": "Brett's Test Blawg", "description": "", "published": "2010-10-06T23:33:31.662Z", "updated": "2011-08-08T06:50:02.005Z", "url": "http://brettmorgan-test-blawg.blogspot.com/", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647", "posts": { "totalItems": 13, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts" }, "pages": { "totalItems": 1, "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages" }, "locale": { "language": "en", "country": "", "variant": "" } } ] }
עבודה עם פוסטים
המערכת מאחזרת פוסטים מבלוג
אפשר לאחזר רשימה של פוסטים מבלוג נתון על ידי שליחת בקשה GET
אל ה-URI של איסוף הפוסטים. ה-URI לאוסף הוא בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts
שליחת בקשה
לדוגמה:
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY
אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ורשימת הפוסטים:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ", "items": [ { "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }, { "kind": "blogger#post", "id": "6069922188027612413", elided for readability } ] }
אחזור של פוסט ספציפי
כדי לאחזר פוסט ספציפי מבלוג, אפשר לשלוח בקשת GET
ל-URI המשאב של הפוסטים. ה-URI של משאב פוסטים הוא בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY
אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
מתבצע חיפוש של פוסט
ניתן לחפש פוסטים מבלוג על ידי שליחת בקשה GET
אל ה-URI של חיפוש הפוסט עם פרמטר שאילתת החיפוש q:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY
אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#postList", "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ", "items": [ { "kind": "blogger#post", "id": "1387873546480002228", "blog": { "id": "3213900" }, "published": "2012-03-23T01:58:00-07:00", "updated": "2012-03-23T01:58:12-07:00", "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228", "title": "Blogger Documentation has moved to developers.google.com", "content": "content elided for readability", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments" } }, ... ] }
הוספה של פוסט
ניתן להוסיף פוסט לבלוג על ידי שליחת בקשה POST
ל-URI של אוסף הפוסט עם גוף JSON:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/
שליחת בקשה
POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/ Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "blog": { "id": "8070105920543249955" }, "title": "A new post", "content": "With <b>exciting</b> content..." }
עליך לאמת את זהותך כדי ליצור פוסט.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "A new post", "content": "With <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
מחיקת פוסט
ניתן למחוק פוסט בבלוג על ידי שליחת בקשה של DELETE
אל ה-URI של המשאב של הפוסט:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
שליחת בקשה
לדוגמה:
DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058 Authorization: /* OAuth 2.0 token here */
עליך לאמת את זהותך כדי למחוק פוסט.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
.
מתבצע אחזור של פוסט לפי הנתיב שלו
כדי לאחזר פוסט מבלוג, אפשר לשלוח בקשת GET
ל-URI של הפוסטים עם פרמטר path
. ה-URI של בקשה לקבלת פוסטים לפי נתיב מופיע בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path
שליחת בקשה
https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY
אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#post", "id": "7706273476706534553", "blog": { "id": "2399953" }, "published": "2011-08-01T19:58:00.000Z", "updated": "2011-08-01T19:58:51.947Z", "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553", "title": "Latest updates, August 1st", "content": "elided for readability", "author": { "id": "401465483996", "displayName": "Brett Wiltshire", "url": "http://www.blogger.com/profile/01430672582309320414", "image": { "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments" } }
עדכון פוסט
אפשר לעדכן פוסט בבלוג על ידי שליחת בקשה של PUT
ל-URI של הפוסט עם גוף JSON:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
שליחת בקשה
PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "kind": "blogger#post", "id": "3445355871727114160", "blog": { "id": "8070105920543249955" }, "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160", "title": "An updated post", "content": "With really <b>exciting</b> content..." }
עליך לאמת את הפוסט כדי לעדכן פוסט.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With really <b>exciting</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
עדכון פוסט עם סמנטיקה של תיקון
אפשר לעדכן פוסט עם הסמנטיקה של התיקון על ידי שליחת בקשה PATCH
אל ה-URI של הפוסט עם גוף JSON:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId
שליחת בקשה
לדוגמה:
PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160 Authorization: /* OAuth 2.0 token here */ Content-Type: application/json { "content": "With absolutely <b>fabulous</b> content..." }
עליך לאמת את הפוסט כדי לעדכן פוסט.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
והתוכן של הפוסט:
{ "kind": "blogger#post", "id": "6819100329896798058", "blog": { "id": "8070105920543249955" }, "published": "2012-05-20T20:08:00-07:00", "updated": "2012-05-20T20:08:35-07:00", "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058", "title": "An updated post", "content": "With absolutely <b>fabulous</b> content...", "author": { "id": "16258312240222542576", "displayName": "Brett Morgan", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } }, "replies": { "totalItems": "0", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments" } }
הוספת תגובות
אחזור תגובות לפוסט
אפשר לאחזר רשימת תגובות לפוסט על ידי שליחת בקשה GET
אל ה-URI של איסוף התגובות. ה-URI לאוסף הוא בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY
"אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ורשימת התגובות:
{ "kind": "blogger#commentList", "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ", "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ", "items": [ { "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }, { "kind": "blogger#comment", "id": "400101178920857170", elided for readability } ] }
אחזור תגובה ספציפית
אפשר לשלוף תגובה ספציפית מפוסט על ידי שליחת בקשה של GET
ל-URI של משאב התגובות. ה-URI של משאב תגובות מופיע בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY
"אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ונתוני התגובות:
{ "kind": "blogger#comment", "id": "9200761938824362519", "post": { "id": "6069922188027612413" }, "blog": { "id": "2399953" }, "published": "2011-07-28T19:19:57.740Z", "updated": "2011-07-28T21:29:42.015Z", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519", "content": "elided", "author": { "id": "530579030283", "displayName": "elided", "url": "elided", "image": { "url": "elided" } } }
עבודה עם דפים
המערכת מאחזרת דפים של בלוג
ניתן לאחזר רשימת דפים עבור בלוג על ידי שליחת בקשה GET
אל ה-URI של איסוף הדפים. ה-URI לאוסף של דפים הוא בפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY
"אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ורשימת הדפים:
{ "kind": "blogger#pageList", "items": [ { "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } } ] }
אחזור של דף ספציפי
ניתן לאחזר דף ספציפי מבלוג על ידי שליחת בקשה GET
אל ה-URI של המשאבים של הדפים. ה-URI של דף
למשאב יש את הפורמט הבא:
https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY
"אין צורך לאמת משתמש כדי לאחזר בלוג ציבורי. האפליקציה לא צריכה לכלול כותרת HTTP אחת (Authorization
) לבקשת בלוג ציבורי. עם זאת, עליך לספק את מפתח ה-API.
ל-Blogger יש גם בלוגים פרטיים שמחייבים אימות.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP
200 OK
ונתוני הדף:
{ "kind": "blogger#page", "id": "273541696466681878", "blog": { "id": "4967929378133675647" }, "published": "2011-07-14T16:16:00.000Z", "updated": "2011-07-14T16:16:23.602Z", "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html", "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878", "title": "Static Content", "content": "elided for readability", "author": { "id": "901569848744", "displayName": "brett", "url": "http://www.blogger.com/profile/16258312240222542576", "image": { "url": "https://resources.blogblog.com/img/b16-rounded.gif" } } }
עבודה עם משתמשים
אחזור משתמש
כדי לאחזר את פרטי המשתמש, שולחים בקשת HTTP GET
ל-URI של המשאב של המשתמשים:
https://www.googleapis.com/blogger/v3/users/userId
שליחת בקשה
GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */
הערה: כדי לאמת את הפרטים של המשתמש, צריך לאמת אותו. לכן, עליכם לספק את הכותרת של HTTP ב-Authorization
עם הבקשה של GET
.
תשובה
אם הבקשה תאושר, השרת יגיב באמצעות קוד סטטוס HTTP מסוג 200 OK
וקישור לרשימה של בלוגים של משתמשים:
{ "kind": "blogger#user", "id": "901569848744", "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744", "blogs": { "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs" } }
פרמטרים רגילים של שאילתה
ניתן להשתמש בפרמטרים הבאים של שאילתה בכל השיטות ובכל המשאבים בממשקי ה-API של Blogger.
פרמטרים של שאילתות שחלים על כל הפעולות ב-Blogger APIs מפורטים בפרמטרים של המערכת.