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

חשוב לדעת: ב-30 בספטמבר 2024 נפסיק את התמיכה ב-Google Data API גרסה 2.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 באמצעות ספריות הלקוח שלנו, בקטע שמתאים לשפת התכנות שלכם במדריך למפתחים הזה.

תוכן עניינים

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

קהל

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

במסמך זה יוצאים מנקודת הנחה שאתם מבינים את הרעיונות הכלליים שעומדים מאחורי Google Data APIs של Google.

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

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

תחילת העבודה

יצירת חשבון Blogger

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

בתהליך של הרשאת בקשות

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

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

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

Blogger GData API תומך גם באפשרויות הרשאה ישנות יותר, כמו 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 תקבע שהבקשה והאסימון תקפים, הוא יחזיר את הנתונים המבוקשים.

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

שולחים GET HTTP לכתובת ה-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>

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

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

יצירת פוסטים

באמצעות 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>

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

כדי לפרסם את הרשומה הזו, צריך לשלוח אותה לכתובת ה-URL של הפוסט בבלוג באופן הבא. קודם כול, צריך להוסיף את הרכיב <entry> של Atom לגוף של בקשת 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 יוצר פוסט בבלוג באמצעות הרשומה ששלחת, ואז מחזיר HTTP קוד הסטטוס 201 CREATED, יחד עם עותק של הפוסט החדש ב של רכיב <entry>. הרשומה שתקבלו תהיה זהה לזו ששלחתם, אבל היא תכלול גם רכיבים שונים שנוספו על ידי Blogger, כמו רכיב <id>.

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

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

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

לדוגמה:

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

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

אם תג ה-ETag לא תואם, המשמעות היא שהרשומה שונתה מאז הפעם האחרונה שביקשת אותה, ומערכת 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 מחזיר 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.
max-results
המספר המקסימלי של רשומות שצריך להחזיר.
orderby
הסדר שבו המערכת מחזירה את הרשומות, למשל lastmodified (ברירת המחדל), starttime או updated.
פרסום מינימלי, פרסום מקסימלי
הגבולות לתאריכי פרסום הרשומה.
start-index
האינדקס שמתחיל ב-1 של התוצאה הראשונה שאוחזרה (לצורך דפדוף).
מעודכן דקות, מעודכן-מקסימום
הגבולות לתאריכי עדכון של רשומות. המערכת מתעלמת מהפרמטרים האלה של שאילתות, אלא אם הפרמטר orderby מוגדר ל-updated.
נתיב
נתיב הקישור הקבוע של פוסט. לדוגמה, בפוסט עם כתובת ה-URL http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html, נתיב הקישור הקבוע הוא /2011/08/bloggers-fresh-new-look.html.
q
מחרוזת מלאה של שאילתת טקסט. כך אפשר לחפש בבלוג פוסטים מתאימים לשאילתה.

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

עדכון פוסטים

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

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

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 את כתובת האתר הבאה עם התוכן של קובץ הייצוא בתור נתוני הבקשה application/atom+xml בתור סוג התוכן:

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

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

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

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

חזרה למעלה