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

חשוב: ב-30 בספטמבר 2024 נפסיק את התמיכה בגרסה 2.0 של Google Data API. כדי להבטיח פונקציונליות מתמשכת, צריך לעדכן את האפליקציות שמסתמכות על v2.0 Google Data API לגרסה האחרונה של ה-API. בגרסה העדכנית ביותר, משתמשים בקישורים שבסרגל הניווט הימני. הערה: אומנם עדיין תהיה תמיכה בבקשות GET מסוימות (כמו פוסטים של כרטיסי מוצר) ככתובות URL של פידים, אבל יש הבדלים קלים בהתנהגות שלהן. מידע מפורט זמין במרכז העזרה של Blogger.

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

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

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

תוכן עניינים

קהל

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

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

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

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

אלה הפרטים של היקפי OAuth 2.0 ב-Blogger GData API:

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

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

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

ציון גרסה

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

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

GData-Version: 2

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

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

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

ה-Blogger Data API מספק פיד שבו מפורטים הבלוגים של משתמש מסוים. הפיד הזה נקרא 'מטא-פיד'.

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

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 Data APIs Protocol או במפרט של Atom 1.0.

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

יצירת פוסטים

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

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

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

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

<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>

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

כדי לפרסם רשומה זו, שלח אותה לכתובת האתר של הפוסט בבלוג באופן הבא. קודם כול, מציבים את רכיב ה-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 יוצר פוסט בבלוג באמצעות הרשומה ששלחתם, ולאחר מכן מחזיר את קוד הסטטוס 201 CREATED של HTTP, יחד עם עותק של הפוסט החדש, בצורת רכיב <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, כולל מרחבי השמות <app:control> ו-<app:draft>, ראו RFC 5023.

מאחזר פוסטים

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

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

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

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

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

לאחר מכן, Blogger מחזיר את קוד הסטטוס 200 OK של HTTP ואת פיד 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 שכוללת את הכותרת If-None-Match של HTTP. בכותרת, מציינים את ה-ETag של הרשומה, שאותו ניתן למצוא במאפיין gd:etag של הרכיב <entry>.

למשל:

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

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

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

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

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

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

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

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 מחזיר קוד מצב 200 OK של HTTP ופיד שמכיל את כל הפוסטים בבלוג שנוצרו בטווח התאריכים שציינת.

אפשר גם להשתמש בפרמטרים 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.

max-results

המספר המקסימלי של הערכים שיש להחזיר.

Orderby

הסדר שבו יש להחזיר ערכים, למשל lastmodified (ברירת המחדל), starttime או updated.

מספר מינימלי של מפרסמים, זמן פרסום מקסימלי

הגבולות של תאריכי פרסום הכניסה.

start-index

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

עדכון-מינימום, עדכון-מקסימום

הגבולות על תאריכי עדכון הכניסה. המערכת מתעלמת מהפרמטרים של השאילתה האלה, אלא אם הפרמטר orderby מוגדר לערך updated.

נתיב

נתיב הקישור הקבוע של פוסט. לדוגמה, לפוסט עם כתובת האתר http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html, הנתיב הקבוע הוא /2011/08/bloggers-fresh-new-look.html.

q

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

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

עדכון פוסטים

כדי לעדכן פוסט קיים בבלוג, קודם מאחזרים את הרשומה שרוצים לעדכן, לאחר מכן משנים אותה, ולאחר מכן שולחים בקשת 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 מאפשר ליצור, לאחזר ולמחוק תגובות. אין תמיכה בעדכון של התגובות (וגם לא בממשק האינטרנט).

יצירת תגובות

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

  <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 לעריכת התגובה. כתובת האתר הזו מודגשת בפיד התגובות שלמעלה.

ייצוא פורמט

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

כדי לייצא או לייבא נתוני בלוג בפורמט הייצוא, תוכלו להיכנס לדף Settings של הבלוג. כדי לאחזר את קובץ הייצוא של בלוג באמצעות 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 שצוינו למעלה לא תומכת בפרמטרים של שאילתה. שתי הבקשות צריכות להכיל גם מידע על אימות, ורק האדמינים של הבלוג יוכלו לייבא ולייצא את הבלוג באמצעות כתובות ה-URL של הפיד.

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

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

חזרה למעלה