Blogger API: שימוש ב-API

ה-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 עשויים להשתנות מעט, בהתאם לסוג האפליקציה שאתם מפתחים. התהליך הכללי הבא חל על כל סוגי האפליקציות:

1. כשהאפליקציה צריכה גישה לנתונים של משתמשים, היא מעבירה ל-Google בקשת גישה בהיקף ספציפי.
2. Google מציגה למשתמש מסך הסכמה ומבקשת לאשר לאפליקציה לשלוח בקשה לחלק מהנתונים שלו.
3. אם המשתמש מסכים, האפליקציה מקבלת מ-Google אסימון גישה לטווח קצר.
4. האפליקציה מבקשת את נתוני המשתמש ומצרפת לבקשה את אסימון הגישה.
5. אם 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 מפורטים בפרמטרים של המערכת.