המדריך למפתחים: פרוטוקול

ממשק ה-API של Blogger Data מאפשר לאפליקציות לקוח להציג ולעדכן תוכן של Blogger בצורת פידים של Google Data API.

בעזרת אפליקציית הלקוח שלכם ב-Blogger Data API תוכלו ליצור פוסטים חדשים בבלוג, לערוך או למחוק פוסטים בבלוגים קיימים ולהגיש שאילתות על פוסטים בבלוג שתואמים לקריטריונים מסוימים.

בנוסף לציון הרקע של היכולות של Blogger Data API, מסמך זה מספק דוגמאות לאינטראקציות בסיסיות עם API באמצעות XML גולמי ו-HTTPS. אחרי קריאת המסמך הזה, תוכלו לקרוא מידע נוסף על האינטראקציה עם ה-API באמצעות ספריות הלקוח שלנו. לשם כך, קראו את הקטעים הספציפיים לשפת תכנות במדריך הזה.

תוכן עניינים

  1. קהל
  2. איך מתחילים
    1. יצירת חשבון Blogger
  3. אישור בקשות
  4. ציון גרסה
  5. אחזור רשימה של בלוגים
  6. יצירת פוסטים
    1. פרסום פוסט בבלוג
    2. יצירת טיוטה של פוסט בבלוג
  7. אחזור פוסטים
    1. אחזור כל הפוסטים בבלוג
    2. אחזור מחדש של פוסט בבלוג
    3. אחזור פוסטים באמצעות פרמטרים של שאילתה
  8. עדכון פוסטים
  9. מחיקת פוסטים
  10. תגובות
    1. יצירת תגובות
    2. אחזור תגובות
    3. מחיקת תגובות
  11. פורמט ייצוא

Audience

המסמך הזה מיועד למתכנתים שרוצים לכתוב אפליקציות לקוח שיכולות ליצור אינטראקציה עם Blogger באמצעות XML ו-HTTPS.

ההנחה היא שהבנת את הרעיונות הכלליים שמאחורי פרוטוקול Google Data APIs.

אם אתם משתמשים במערכת UNIX ואתם רוצים לנסות את הדוגמאות במסמך הזה בלי לכתוב קוד, תוכלו להיעזר בכלי שורת הפקודה של UNIX curl או בכלי wget. למידע נוסף, תוכלו לעיין בדפים הידניים.

במדריך העזר לפרוטוקולים ניתן למצוא מידע על קובצי עזר ב-Blogger Data API.

איך מתחילים

יצירת חשבון Blogger

ייתכן שתרצו להירשם לחשבון Blogger למטרות בדיקה. Blogger משתמש בחשבונות Google, כך שאם כבר יש לכם חשבון Google, אתם מוכנים.

מתן הרשאה לבקשות

כאשר הבקשה שלכם מבקשת נתוני משתמש שאינם גלויים לכול, היא חייבת לכלול אסימון הרשאה. אסימון ההרשאה גם מזהה את האפליקציה שלכם ב-Google.

הסבר על פרוטוקולים של הרשאות

מומלץ להשתמש ב-OAuth 2.0 כדי לאשר בקשות.

ממשק ה-API של Blogger GData תומך גם באפשרויות הרשאה ישנות יותר, כגון OAuth 1.0, AuthSub או ClientLogin. עם זאת, ברוב המקרים לא מומלץ להשתמש באפשרויות האחרות האלה. אם באפליקציה שלכם כבר נעשה שימוש באפשרויות האלה, אנחנו ממליצים לעבור ל-OAuth 2.0 אם אפשר.

אם לאפליקציה שלכם יש דרישות חריגה מסוימות, כמו התחברות בו-זמנית לבקשת גישה לנתונים (היברידי) או הענקת הרשאה ברמת הדומיין (2LO), לא תוכלו להשתמש באסימונים מסוג OAuth 2.0 בכל הדומיין. במקרים כאלה, צריך להשתמש באסימוני OAuth 1.0.

מתן הרשאה ל-OAuth 2.0

כשמשתמש מאומת צריך לאשר ל-Blogger GData API נתונים לא ציבוריים של משתמשים.

הפרטים של תהליך ההרשאה, או "flow," עבור OAuth 2.0, משתנים מעט בהתאם לסוג האפליקציה שכותבים. התהליך הכללי הבא חל על כל סוגי הבקשות:

  1. כשאתם יוצרים את האפליקציה שלכם, אתם צריכים לרשום אותה ב-Google. לאחר מכן Google תספק את המידע הדרוש לך, כמו מספר לקוח וסוד, של לקוח.
  2. כשהאפליקציה שלכם צריכה גישה לנתוני משתמשים, היא תבקש מ-Google היקף מסוים של גישה.
  3. Google מציגה למשתמש תיבת דו-שיח מסוג OAuth, שבה היא מבקשת לאשר לאפליקציה לבקש נתונים מסוימים.
  4. אם המשתמש מאשר, Google נותנת לאפליקציה שלך אסימון גישה לטווח קצר.
  5. האפליקציה שלך מבקשת נתוני משתמש וצירפת את אסימון הגישה לבקשה.
  6. אם Google תקבע שהבקשה והאסימון שלך תקפים, היא תחזיר את הנתונים שביקשת.

חלק מהתהליכים כוללים שלבים נוספים, כמו שימוש באסימוני רענון, כדי להשיג אסימוני גישה חדשים. למידע מפורט על תהליכי עבודה עבור סוגים שונים של אפליקציות, ניתן לעיין בתיעוד של OAuth&230 של Google.

כאן מופיע מידע על היקף OAuth 2.0 של Blogger GData API:

https://www.blogger.com/feeds/

כדי לבקש גישה באמצעות OAuth 2.0, האפליקציה שלכם צריכה את פרטי ההיקף, וכן מידע ש-Google מספקת במהלך רישום האפליקציה (למשל, מספר הלקוח ו/או סוד הלקוח).

טיפ: ספריות הלקוח של Google APIs יכולות לטפל בחלק מתהליך ההרשאה עבורכם. הן זמינות במגוון שפות תכנות. פרטים נוספים זמינים בדף ספריות ודוגמאות.

ציון גרסה

בכל בקשה ששולחים באמצעות ה-API של Blogger יש לציין את גרסה 2 של ה-API.

כדי לציין מספר גרסה, יש להשתמש בכותרת ה-HTTP GData-Version:

GData-Version: 2

לחלופין, אם לא ניתן להגדיר כותרות HTTP, ניתן לציין v=2 כפרמטר של שאילתה בכתובת ה-URL. אבל עדיף להשתמש בכותרת HTTP.

הערה: ספריות הלקוח מספקות כותרות של גרסאות מתאימות באופן אוטומטי, לכן אין להשתמש בפרמטר השאילתה של v=2 כשאתם משתמשים בספריית לקוחות.

מתבצע אחזור של רשימת בלוגים

ממשק ה-API של Blogger Data מספק עדכון שמפרט את הבלוגים של משתמש מסוים; העדכון הזה נקרא "metafeed."

שליחת HTTP GET לכתובת ה-URL הבאה כדי לאחזר את רשימת הבלוגים:

https://www.blogger.com/feeds/profileID/blogs

כאשר מזהה הפרופיל הוא המספר שמופיע בכתובת ה-URL של דף הפרופיל של המשתמש.

הערה: תוכלו גם להחליף את default עבור מזהה המשתמש, המורה ל-Blogger להחזיר את רשימת הבלוגים עבור המשתמש שפרטי הכניסה שלו מלווים את הבקשה.

רשומה במטא-פיד עשויה להיראות כך:

<entry gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:user-userNumber.blog-blogID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/profileID/blogs/blogID' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  ...
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </author>
</entry>

למידע על המשמעות של כל אחד מהרכיבים האלו, ניתן לעיין במסמך של Google APIs Data Protocol Protocol או במפרט של Atom 1.0.

אם הבקשה נכשלה מסיבה כלשהי, Blogger עשוי להחזיר קוד סטטוס שונה. מידע נוסף על קודי סטטוס של HTTP זמין גם במסמך הסבר על הפרוטוקולים ב-API של Google Data.

יצירת פוסטים

ה-Blogger Data API מאפשר ליצור ולפרסם רשומות חדשות בבלוג, וגם ליצור טיוטות של רשומות.

פרסום פוסט בבלוג

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

קודם כל, יוצרים ייצוג XML של הפוסט שרוצים לפרסם. ה-XML הזה צריך להיות בצורת רכיב Atom <entry>, שעשוי להיראות כך:

<entry xmlns='http://www.w3.org/2005/Atom'>
  <title type='text'>Marriage!</title>
  <content type='xhtml'>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
      <p>He is the last man on earth I would ever desire to marry.</p>
      <p>Whatever shall I do?</p>
    </div>
  </content>
  <category scheme="http://www.blogger.com/atom/ns#" term="marriage" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
</entry>

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

כדי לפרסם את הערך הזה, יש לשלוח אותו לכתובת ה-URL של הפוסט בבלוג כך: קודם צריך למקם את הרכיב Atom <entry> בגוף הבקשה החדשה POST, באמצעות סוג התוכן application/atom+xml. לאחר מכן יש לאתר את כתובת ה-URL של הפוסט בבלוג בבלוג על ידי איתור הרכיב <link> שבו מאפיין rel מסתיים ב-#post. כתובת ה-URL של הפוסט בבלוג ניתנת כמאפיין href של הרכיב הזה, בפורמט הבא:

https://www.blogger.com/feeds/blogID/posts/default

הערה: כתובת ה-URL זהה לכתובת ה-URL בתג <link rel="service.post"> שמופיע בקטע <head> של גרסת הבלוג שניתנת לקריאה על ידי משתמשים.

Blogger יוצר פוסט בבלוג באמצעות הערך ששלחת, ולאחר מכן מחזיר קוד סטטוס HTTP201 CREATED, יחד עם עותק של הפוסט החדש בפורמט של רכיב <entry>. הרשומה שהוחזרה היא אותה רשומה ששלחתם, אבל היא מכילה גם רכיבים שונים שנוספו על ידי Blogger, כמו רכיב <id>.

אם הבקשה נכשלה מסיבה כלשהי, Blogger עשוי להחזיר קוד סטטוס שונה. מידע על קודי הסטטוס זמין במסמך העזר בנושא פרוטוקול Google Data API.

יצירת טיוטה של פוסט בבלוג

טיוטות של פוסטים נוצרות באותו אופן כמו פוסטים ציבוריים, אבל עם רכיב <app:control> נוסף ברשומה שמציינת שצריך לפרסם את הפוסט (עדיין)

אלמנט <app:control> הזה צריך לכלול אלמנט אחד מסוג <app:draft> כצאצא:

<app:control xmlns:app='http://www.w3.org/2007/app'>
  <app:draft>yes</app:draft>
</app:control>

כדי שהמערכת תוכל לזהות את הפוסט כטיוטה, הנתונים שכלולים ברכיב <app:draft> צריכים להיות המחרוזת yes.

אפשר להפוך טיוטה קיימת של פוסט בבלוג לפוסט שפורסם על ידי אחזור הפוסט של הטיוטה, הגדרת הנתונים של רכיב <app:draft> למחרוזת no ולאחר מכן עדכון הפוסט. האחזור והעדכון של הפוסטים מפורטים בשני הקטעים הבאים.

הערה: מידע נוסף על ה-Atom Publishing Protocol, כולל מרחבי השמות <app:control> ו-<app:draft>, זמין במאמר RFC 5023.

המערכת מאחזרת פוסטים

בקטעים הבאים מתואר איך לאחזר רשימה של פוסטים בבלוג עם או בלי פרמטרים של שאילתה.

אתם יכולים ליצור שאילתה בפיד גלוי לכול של Blogger ללא אימות. לכן אין צורך להגדיר את פרמטר ההרשאה באחזור פוסטים בבלוג מבלוג ציבורי.

מתבצע אחזור של כל הפוסטים בבלוג

כדי לאחזר את הפוסטים של המשתמש, שלח בקשת HTTP GET לכתובת ה-URL של הפיד של הבלוג. לאחר מכן Blogger מחזיר פיד שמכיל את רשומות הבלוג המתאימות. לדוגמה, כדי לקבל רשימה של פרסומי בלוגים עבור liz@gmail.com, שולחים את בקשת ה-HTTP הבאה ל-Blogger (עם הערך המתאים במקום blogID, כמובן):

GET https://www.blogger.com/feeds/blogID/posts/default

לאחר מכן, Blogger מחזיר קוד סטטוס HTTP 200 OK והפיד הרגיל Atom 1.0 שמכיל את הפוסטים בבלוג.

הדוגמה הבאה היא פיד של בלוג עם פוסט אחד בלבד. שימו לב: ערכתם קצת את הדוגמה הזו כדי שאנשים יוכלו לקרוא אותה יותר בקלות. באופן ספציפי, פיד Blogger אמיתי מכיל מזהים וכתובות URL בפועל.

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <subtitle type='html'></subtitle>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </author>
  <generator version='7.00'
    uri='http://www2.blogger.com'>Blogger</generator>
  <entry gd:etag='W/"D0YHRn84eip7ImA9WxZUFk8."'>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <published>2008-04-07T20:25:00.005-07:00</published>
    <updated>2008-04-07T20:25:37.132-07:00</updated>
    <title>Quite disagreeable</title>
    <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
      this evening. I found him quite disagreeable.&lt;/p&gt;</content>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2008/04/quite-disagreeable.html' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>noreply@blogger.com</email>
    </author>
  </entry>
</feed>

מתבצע אחזור מחדש של פוסט בבלוג

אם אתם רוצים לאחזר פוסט שאחזרתם בעבר, תוכלו לשפר את היעילות על ידי כך ש-Blogger ישלח את הפוסט רק אם הוא השתנה מאז הפעם האחרונה שבה שחזרתם אותו.

כדי לבצע אחזור מותנה מסוג זה, יש לשלוח בקשת HTTP GET שכוללת כותרת HTTP If-None-Match. בכותרת, מציינים את ערך ה-ETag של הרשומה'.

למשל:

If-None-Match: W/"D08FQn8-eil7ImA9WxZbFEw."

כש-Blogger מקבל את הבקשה הזו, הוא בודק אם הערך שביקשתם ב-ETag זהה לזה של ה-ETag שציינת. אם ה-ETags תואמים, הערך לא השתנה, ו-Blogger מחזיר קוד סטטוס HTTP 304 Not Modified.

אם ה-ETags לא תואמים, הערך השתנה מאז הפעם האחרונה שביקשתם ו-Blogger מחזיר את הערך.

למידע נוסף על ETags, אפשר לעיין במדריך העזר של Google Data APIs.

אחזור פוסטים באמצעות פרמטרים של שאילתה

בעזרת Blogger Data API תוכלו לבקש קבוצה של רשומות שתואמות לקריטריונים מסוימים, כגון בקשת פוסטים בבלוג שפורסמו או עודכנו בטווח תאריכים נתון.

לדוגמה, כדי לשלוח שאילתה בטווח תאריכים, מוסיפים את הפרמטרים published-min ו-published-max לכתובת ה-URL של הבקשה. כדי לקבל את כל הערכים בבלוג שנוצרו בין 16 במרץ 2008 ל-24 במרץ 2008, שלחו בקשת HTTP לכתובת האתר של הפיד של הבלוג:

GET https://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59

כששולחים את הבקשה ל-GET, Blogger מחזיר קוד סטטוס HTTP 200 OK ופיד שמכיל את כל הפוסטים בבלוגים שנוצרו בטווח התאריכים שציינתם.

הפרמטרים של updated-min ושל updated-max עשויים גם לשמש לעדכון כל רשומות הבלוג בטווח נתון. עם זאת, המערכת תתעלם מהפרמטרים האלה אלא אם הפרמטר orderby יוגדר גם כ-updated.

ב-Blogger Data API יש תמיכה בפרמטרים הבאים של שאילתות:

Alt
סוג הפיד להחזרה, למשל atom (ברירת המחדל) או rss.
/category
קביעת קטגוריות (נקראות גם תוויות) לסינון תוצאות הפיד. לדוגמה, הפונקציה https://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie מחזירה רשומות עם התוויות Fritz ו-Laurie.
תוצאות מקסימליות
המספר המרבי של ערכים להחזרה.
Orderby
הסדר שבו יש להחזיר ערכים, כגון lastmodified (ברירת המחדל), starttime או updated.
דקות פרסום, מועד פרסום מרבי
הגבולות של תאריכי הפרסום.
אינדקס התחלתי
האינדקס מבוסס-1 של התוצאה הראשונה שאוחזר (להחלפה).
הגרסה המעודכנת, דקות מעודכנות
הגבולות בתאריכי עדכון הרשומות. המערכת תתעלם מהפרמטרים של השאילתות האלה, אלא אם הפרמטר orderby מוגדר כ-updated.
נתיב
נתיב הקישור הקבוע לפוסט. לדוגמה, בפוסט עם כתובת האתר http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html, נתיב הקישור הקבוע הוא /2011/08/bloggers-fresh-new-look.html.
q
מחרוזת שאילתה מלאה של טקסט. כך אפשר לחפש בבלוג פוסטים שתואמים לשאילתה.

למידע נוסף על פרמטרים של שאילתות, ניתן לעיין במדריך העזר לממשקי API של Blogger Data ובמדריך העזר לממשקי API של Google Data.

מתבצע עדכון פוסטים

כדי לעדכן פוסט קיים בבלוג, קודם כל צריך לאחזר את הרשומה שאתם רוצים לעדכן, ואז לשנות אותה ואז לשלוח בקשת PUT, עם הרשומה המעודכנת בגוף ההודעה, לכתובת ה-URL לעריכה של הפוסט. יש לוודא שהערך <id> ברשומה PUT תואם בדיוק ל-<id> של הערך הקיים.

כתובת ה-URL לעריכה מודגשת ברשומה הבאה:

<entry gd:etag='W/"CUYDSXo8fSp7ImA9WB9UFkU."'>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-11-08T18:10:00.000-08:00</published>
  <updated>2006-11-08T18:10:14.954-08:00</updated>
  <title type='text'>Quite disagreeable</title>
  <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
    this evening. I found him quite disagreeable.&lt;/p&gt;</content>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default/postID'>
  </link>
  <link rel='edit' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
  </link>
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

חשוב: כדי להבטיח תאימות קדימה, חשוב להקפיד: כאשר PUT רשומה מעודכן, אתם שומרים את כל רשומות ה-XML שהיו זמינות כשאחזרתם את הרשומה מ-Blogger. אחרת, כשאנחנו מטמיעים פריטים חדשים וכוללים <new-awesome-feature> רכיבים בפיד, הלקוחות לא יחזירו אותם והם יפספסו את המשתמשים. ספריות הלקוח של Google Data API מטפלות כולן כראוי. לכן, אם אתם משתמשים באחת מהספריות, אתם מוכנים.

הערה: כרגע אין תמיכה בשינוי נתוני המחבר המשויכים לפוסטים.

טיפ לפתרון בעיות: חומות אש מסוימות חוסמות הודעות HTTP PUT. כדי לעקוף את הבעיה, אפשר לכלול כותרת X-HTTP-Method-Override: PUT בבקשת POST. פרטים נוספים ניתן למצוא במסמך מידע בסיסי על פרוטוקולי Google Data API.

מחיקת פוסטים

כדי למחוק פוסט, יש לשלוח בקשה אל DELETE לכתובת ה-URL לעריכה של הפוסט. זוהי אותה כתובת URL לעדכון פוסטים.

טיפ לפתרון בעיות: חומות אש מסוימות חוסמות הודעות HTTP DELETE. כדי לעקוף את הבעיה, אפשר לכלול כותרת X-HTTP-Method-Override: DELETE בבקשת POST. פרטים נוספים ניתן למצוא במסמך מידע בסיסי על פרוטוקולי Google Data API.

תגובות

ה-Blogger Data API מאפשר ליצור, לאחזר ולמחוק תגובות. אין תמיכה בעדכון תגובות (וגם לא זמין בממשק האינטרנט).

יצירת תגובות

כדי לפרסם תגובה, צריך ליצור רכיב Atom <entry> כמו זה:

  <entry xmlns='http://www.w3.org/2005/Atom'>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
  </entry>

כדי לפרסם את התגובה הזו, יש להציב את רכיב ה-Atom <entry> בתוך גוף בקשת POST חדשה, באמצעות סוג התוכן application/atom+xml. לאחר מכן, שלחו את בקשת POST לכתובת ה-URL המתאימה של Blogger:

POST https://www.blogger.com/feeds/blogID/postID/comments/default

הערה: כרגע אפשר לפרסם תגובות רק בבלוג שבבעלות המשתמש המאומת.

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

מתבצע אחזור של התגובות

ניתן לאחזר את התגובות לפוסט ספציפי על ידי שליחת GET לכתובת ה-URL של פיד התגובות הזה:

GET https://www.blogger.com/feeds/blogID/postID/comments/default

לחלופין, אפשר לקבל את התגובות מכל הפוסטים באמצעות פיד התגובות בבלוג:

GET https://www.blogger.com/feeds/blogID/comments/default

הבקשות האלה יחזירות פיד תגובות שנראה כך:

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"CUYMQ348fyp7ImA9WB9UFkU."'>
  <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id>
  <updated>2007-12-14T17:46:22.077-08:00</updated>
  <title>Comments on Lizzy's Diary: Quite disagreeable</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/postID/comments/default' />
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/postID/comments/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>noreply@blogger.com</email>
  </author>
  <generator version='7.00'
    uri='http://www.blogger.com'>Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry gd:etag='W/"CUYCQX47eSp7ImA9WB9UFkU."'>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-12-14T17:46:00.001-08:00</published>
    <updated>2007-12-14T17:46:00.001-08:00</updated>
    <title>Darcy FTW!</title>
    <content type='html'>Darcy FTW!</content>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html?showComment=1197683160001#ccommentID'
      title='' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>liz@gmail.com</email>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html'
      ref='tag:blogger.com,1999:blog-blogID.post-postID'
      source='http://www.blogger.com/feeds/blogID/posts/default/postID'
      type='text/html' />
  </entry>
</feed>

מחיקת תגובות

כדי למחוק תגובה, יש לשלוח בקשת DELETE אל כתובת ה-URL לעריכה של התגובה. כתובת ה-URL הזו מודגשת בפיד התגובות שלמעלה.

פורמט הייצוא

Blogger מאפשר למשתמשים לייצא ולייבא את הבלוגים שלהם באמצעות קובץ ייצוא של Blogger. קובץ הייצוא הזה מכיל את כל הפוסטים והתגובות לבלוג אחד. הפורמט של קובץ הייצוא זהה לפורמט Atom שמתואר בקטעים לאחזור פוסטים ותגובות. קובץ הייצוא יכלול את התוכן של פיד הפוסטים ואת התוכן של פיד התגובות, משולבת במסמך אחד.

כדי לייצא או לייבא נתוני בלוג באמצעות פורמט הייצוא, אפשר להיכנס לדף הגדרות של הבלוג. כדי לאחזר את קובץ הייצוא עבור בלוג באמצעות Data API, צריך להשתמש בכתובת ה-URL הבאה:

GET https://www.blogger.com/feeds/blogID/archive

כדי לייבא את קובץ הייצוא, יוצרים בקשה ב-POST לכתובת ה-URL הבאה, עם תוכן קובץ הייצוא בתור נתוני הבקשה, ו-application/atom+xml בתור סוג התוכן:

POST https://www.blogger.com/feeds/blogID/archive/full

אף אחת מכתובות ה-URL שלמעלה לא תומכת בפרמטרים של שאילתה. שתי הבקשות צריכות לכלול גם מידע על אימות, ורק מנהלי בלוג יוכלו לייבא/לייצא את הבלוג באמצעות כתובות האתרים של העדכונים האלה.

הערה: אם אתם יוצרים קובץ ייצוא משלכם ב-Blogger, יש כרגע הגבלה אחת על הסדר של רשומות הפוסט והתגובות. קובץ הייצוא של Blogger יציג תחילה את כל הפוסטים, ואז את כל התגובות. מותר למקם פוסטים ותגובות בין תגובות כל עוד רשומת התגובה מופיעה אחריה.

למידע נוסף על אופן השימוש של Blogger בפורמט Atom בקובץ הייצוא, ניתן לעיין במדריך העזר לפרוטוקול.

חזרה למעלה