Google Developers Japan: Google Person Finder API のドキュメンテーションの翻訳について

Local blog for Japanese speaking developers

Google Person Finder API のドキュメンテーションの翻訳について

2011年3月13日日曜日

Posted by 山崎富美 / Developer Relations Team[先日「東北地方太平洋沖地震を受けて」というブログ記事でご紹介した Google Person Finder ですが、API のドキュメンテーションを翻訳して欲しいとのご要望を頂いたのを受けて、ソフトウェアエンジニアの花岡俊行が翻訳をしてくれました。なお、正式版の翻訳については code site に掲載されるのをお待ちください-山崎]●Google Person Finder Data API documentationHow to download or upload data using the Person Finder API.Person Finder API を使ったデータのダウンロード・アップロード方法Person Finder アプリケーションはレコードを People Finder Interchange Format (PFIF) で保存、エクスポートします。PFIF は XML ベースのフォーマットです。PFIF に関するドキュメントは以下より参照できます。PFIF 1.2 specificationPFIF 1.2 example documentPFIF FAQ and implementation guidelines●Downloading data from Person FinderPerson Finder からデータをダウンロードする方法Person Finder からデータをダウンロードするには、authorization token が必要です。authorization token はこちらのフォームから申し込むことができます。PFIF 1.2 person feed と note feed はここからアクセスできます。
https://subdomain.person-finder.appspot.com/feeds/person?key=auth_token
https://subdomain.person-finder.appspot.com/feeds/note?key=auth_tokenデフォルトでは、これらの feed は最も最近に追加された person レコードや note レコードを日付順に新しいものから返します。以下の query パラメータがサポートされています。

max_results: Return up to the specified number of results (maximum 200).

max_results: 指定された数を上限として結果を返します。(指定できる上限は 200)

skip: Skip the specified number of records before returning the next max_results results.

skip: 次の|max_results|個の結果を返す前に、指定された数の結果をスキップします。

min_entry_date: Return only results with an entry_date greater than or equal to the specified timestamp, which should be in UTC in yyyy-mm-ddThh:mm:ssZ format. If this parameter is specified, results will be returned in forward chronological order.

min_entry_date:指定された日付以降のタイムスタンプの entry_gate を持つ結果のみを返します。タイムスタンプは UTC で yyyy-mm-ddThh:mm:ssZ のフォーマットで指定します。このパラメータが指定された場合、結果は日付順に古いものから返します。

person_record_id: Return only notes for this person record. This parameter is only valid for the note feed.

person_record_id: note feed のみで有効なパラメータです。指定された person record に対する notes のみ返します。

person_record_id パラメータは特定の人に対する note feed を subscribe するのに使えます。Google Person Finder データベースと同期した他のデータベースが必要な場合、min_entry_date と skip パラメータを使って更新の増加分をダウンロードすることができます。最後に Google Person Finder から受け取った entry_date を、最初のリクエストの min_entry_date として用いてください。そしてそのリクエストの結果得られた中で最新の entry_date を、さらに次のリクエストの min_entry_date に用います。skip パラメータは既に得られた、同じ entry_date を持つ record をスキップするのに使うことができます。このアルゴリズムは tools/download_feed.py で実装されています。特定の人の PFIF person_record_id がわかっている場合、notes 付きの単一の PFIF person record を次の URL から得ることができます。
https://subdomain.person-finder.appspot.com/api/read?key=auth_token&id=person_record_id●Using the Person Finder Search APIPerson Finder Search API を使う方法Person Finder Search API を使うには、authorization token が必要です。authorization token はこのフォームより申し込むことができます。search API はここからアクセスできます：
https://person-finder.appspot.com/api/search?key=auth_token&subdomain=subdomain&q=your query ●Uploading data into Person FinderPerson Finder にデータをアップロードする方法
ひとつまたは複数の PFIF record を Person Finder にアップロードすることができます。アップロードは次の URL に XML ファイルを post することによって行えます。https://subdomain.person-finder.appspot.com/api/write?key=auth_token
PFIF 1.1, 1.2 の両方が受理されます。auth_token を得るには、pf-authkey@google.com に連絡してください。どの PFIF source domain に対して authorization token を使うかを明記する必要があります。authorization token は、その domain を prefix にもつ person_record_id の person record のアップロードのみに使うことができます。XML ファイルが用意できたら、次のコマンドでアップロードすることができます。curl -X POST -H 'Content-type: application/xml' --data-binary @your_file.xml \ https://subdomain.person-finder.appspot.com/api/write?key=auth_token
elements with nested elements. To understand the proper XML format, see the PFIF example document. We recommend that you upload a single record or a small number of records as a test, retrieve the records using the Individual Person Record API (/api/read), and view the records on the site to verify that the results are what you expected. Pay careful attention to the handling of accented letters, note text, source URLs, and photo URLs (if you have them).XML ドキュメントは、ネストされた 要素を持つことができます。厳密な XML フォーマットについての詳細は、PFIF example document を参照してください。まずテストとして、単一か少数の record をアップロードし、その結果を individual Person Record API (/api/read) を使って record を検索し、結果が予想通りになっているかどうかを確かめてみることをお勧めします。アクセント付き文字、note 文字列、source URL、photo URL を使っている場合は、特に注意を払ってください。
Due to the size limitation on POST requests, you should split up files into batches of 100 elements. If you encounter an error, or need to correct problems in a previous upload, it is safe to upload the same records again. Records will replace existing records with the sameperson_record_id or note_record_id.
POST リクエストのサイズ制限により、ファイルを 100 要素ごとに分割する必要があります。エラーが発生した場合、または以前のアップロードを訂正する必要がある場合、同じ record をもう一度送っても問題ありません。同一の person_record_id か note_record_id を持つ record は上書きされます。

The response will be an XML document like this:
response は次のような XML document になるでしょう：
<?xml version="1.0"?> <status:status> <status:write> <status:record_type>pfif:person</status:record_type> <status:parsed>1</status:parsed> <status:written>1</status:written> <status:skipped> </status:skipped> </status:write> <status:write> <status:record_type>pfif:note</status:record_type> <status:parsed>1</status:parsed> <status:written>1</status:written> <status:skipped> </status:skipped> </status:write> </status:status>それぞれの <status:write> 要素はひとつの書き込みバッチ操作を表しています。<status:record_type> はバッチ操作の種類です。<status:parsed> はいくつの XML record が正しくパースできたかを記述しています。<status:written> はいくつの record がデータストアに書き込まれたか記述しています。上の例では 1 つの person と 1 つの note が正しく書き込まれました。問題が起こったときは次のようになるでしょう。<?xml version="1.0"?> <status:status> <status:write> <status:record_type>pfif:person</status:record_type> <status:parsed>1</status:parsed> <status:written>0</status:written> <status:skipped> <pfif:person_record_id>google.com/person.4040</pfif:person_record_id> <status:error>not in authorized domain: u'google.com/person.4040'</status:error> </status:skipped> </status:write> <status:write> <status:record_type>pfif:note</status:record_type> <status:parsed>1</status:parsed> <status:written>0</status:written> <status:skipped> <pfif:note_record_id>zesty.ca/note.53</pfif:note_record_id> <status:error>ValueError: bad datetime: u'xyz'</status:error> </status:skipped> </status:write> </status:status> entry describes the reason why a particular record was skipped, and includes the record ID if one was given.
それぞれのエントリはあるレコードがなぜスキップされたか記述しており、record ID が指定されていればそれを含みます。
When you upload person or note records, you will be replacing any existing records with the same record ID. It should be safe to upload the same data multiple times while you fix formatting problems.
person record や note record をアップロードした場合、同一の record ID をもつ record はすべて上書きされます。フォーマット問題を修正するために同一のデータを複数回アップロードすることは安全に行えます。

ラベル

ブログアーカイブ

2024
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2023
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2022
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2021
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2020
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2019
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2018
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2017
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2016
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2015
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月

2014
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2013
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2012
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2011
- 12月
- 11月
- 10月
- 9月
- 8月
- 7月
- 6月
- 5月
- 4月
- 3月
- 2月
- 1月

2010
- 12月
- 11月

Feed

"プロダクトに関するご意見はプロダクトフォーラムにお願いします"

Google
Privacy
Terms