מדריך עזר

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

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

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

תוכן עניינים

קהל

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

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

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

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

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

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

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

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

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

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

המערכת מתעלמת מהפרמטרים של השאילתה updated-min ו-updated-max, אלא אם הפרמטר orderby מוגדר ל-updated. לדוגמה, כתובת האתר הבאה מאחזרת את כל הפוסטים בבלוג שעודכנו מ-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 Publishing Protocol.

שאר החלק הזה מספק כמה הערות ספציפיות על השימוש של 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 תואמת ל-post date שהמשתמש יכול להגדיר ב-GUI של Blogger.

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

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

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

חזרה למעלה