מדריך עזר

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

במסמך הזה מפורט מסמך עזרה בנושא פרוטוקול הנתונים הגולמי (XML ו-HTTP) של Blogger Data API.

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

תוכן עניינים

1. קהל
2. סוגי פידים ב-Blogger
3. הפניה לפרמטרים של שאילתות ב-Blogger
4. חומר עזר בנושא רכיבים ב-Blogger
   1. רשומות של טיוטות
   2. תאריכי פרסום ותאריכי עדכון
   3. קישור תגובות לפוסטים

קהל

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

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

סוגי הפידים של Blogger

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

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

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

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

מסמך עזר בנושא פרמטרים של שאילתות ב-Blogger

Blogger Data API תומך כמעט בכל פרמטרי השאילתות הרגילים של Google Data API.

Blogger לא תומך ב-q (חיפוש טקסט) וב- author פרמטרים.

הפרמטרים של השאילתה updated-min ו-updated-max המערכת מתעלמת ממנו, אלא אם הפרמטר orderby מוגדר לערך updated לדוגמה, כתובת ה-URL הבאה מאחזרת את כל הבלוג פוסטים שעודכנו מ-16 במרץ 2008 ל-24 במרץ 2008:

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

מסמך עזר בנושא רכיבי Blogger

ב-Blogger Data API נעשה שימוש רק באלמנטים רגילים של Atom. למידע נוסף, אפשר לעיין במפרט של פורמט הסינדיקציה Atom 1.0 ובפרוטוקול הפרסום של Atom.

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

רשומות טיוטות

טיוטה של רשומה בבלוג מסומנת באמצעות <app:draft> שמוגדר במסמך Atom Publishing Protocol. דוגמה לטיוטת רשומה:

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

אם לא צוין רכיב <draft>, לא צוין ערך טיוטה.

תאריכי פרסום ותאריכים מעודכנים

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

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

עם זאת, אם הלקוח כן יצוין ערך לרכיב <published> כשיוצרים או עורכים רשומה, מערכת Blogger תגדיר את תאריך הפרסום של הרשומה לפי הערך שצוין. זה יכול להיות שימושי למשימות כמו ייבוא רשומות ישנות ממערכת בלוגים אחרת (תוך שמירה על תאריכי היצירה המקוריים).

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

אפשר להשתמש ב-Google Data API הסטנדרטי published-min, published-max, updated-min וגם updated-max פרמטרים של שאילתה לבקשת רשומות על סמך <published> או <updated> ערכים. אבל, לפעמים להערות לגבי שליחת שאילתות בתאריכים מעודכנים, אפשר להיכנס ל-Blogger הפניה לפרמטרים של שאילתה.

קישור תגובות לפוסטים

ייצוא של Blogger פורמט שכולל גם פוסטים וגם רשומות של תגובות במסמך אחד של פיד Atom. כדי להבדיל בין שני סוגי הרשומות, מערכת Blogger משתמשת ברכיב <atom:category>. לאלמנט הזה יהיה פרמטר term שמשקף אם הרשומה היא לפוסט או לתגובה.

בנוסף, הקישור בין הרשומה של התגובה לבין הרשומה של הפוסט שהיא שייכת אליו מתבצע באמצעות תוסף Atom Threading. בדוגמה הבאה, הרכיב <thr:in-reply-to> ברשומת התגובה יצביע על הפוסט באמצעות מזהה רשומת הפוסט בפרמטר ref. הוא גם מקשר לכתובת ה-URL של הפוסט ב-HTML דרך הפרמטר href.

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

חזרה למעלה