賃貸の募集に使う室内・外観の写真を掲載前に見て、人・表札・車のナンバー・私物の写り込みと、撮り直しが要る暗い・傾いた写真を拾う

処理の起点を決める

物件の台帳の「写真」の欄が「済み」になったことを起点にします。 ただし、Google Apps Script のインストール型トリガーには、ドライブにファイルが追加されたときに動くものはありません。公式の案内に挙がっているのは、開いたとき・編集したとき・変更したとき・フォームの送信・カレンダーの予定と、時間主導型のトリガーです。そこで、時間主導型のトリガーで10分ごとに台帳を見に行きます。

時間主導型のトリガーは毎分から月1回まで選べ、実行の時刻はいくらかばらつくことがあるとされています。写真フォルダそのものを見張らないのは、撮影者が写真を入れている途中で点検が走るのを避けるためです。

点検が終わった部屋は、台帳の「点検」の欄に日時を書き、 次の実行では「写真」が済みで「点検」が空の部屋だけを拾います。

1回の実行で処理する部屋は、5室までにします。Google Apps Script の1回の実行は最大6分です。時間が足りなくなる前に止め、残りは次の実行に回します。

入力データを集める

質を決めるのは、いちばん下の掲載の基準です。 何が写っていたら隠し、何が写っていたら撮り直すのかが文書になっていないと、AIの返す結果をどう扱うかが、また担当者ごとに分かれます。

掲載の基準は、次のような表で作ります。

データの取得方法を決める

写真は、部屋ごとのフォルダからスクリプトが読みます。 フォルダの ID は台帳の列に持たせておき、ファイルの一覧を取って、1枚ずつ中身を読み出します。

画像は Base64 のデータ URL にして渡します。 共有ドライブの写真は社外から見られない設定なので、URL で渡すことはできません。写真を一時的に公開して URL を渡す、という作り方はしません。 公開した瞬間に、点検前の写真が社外から見える状態になります。

1回のリクエストには、写真を1枚だけ入れます。 複数枚をまとめて渡すこともできますが、どの結果がどの写真のものかを取り違えないために、1枚ずつにします。 Google Apps Script の URL フェッチは1回の送信が最大50MB、1日の回数は Google Workspace のアカウントで100,000回です。時間主導型トリガーの1日の合計の実行時間は6時間までで、 1枚10秒としても1日250枚なら40分ほどで収まります。

AIへ渡す前に整形する

1. 形式の確認 … PNG、JPEG、WEBP、アニメーションでない GIF 以外は見分けに渡しません。スマートフォンの HEIC 形式の写真は、撮影者に JPEG で入れ直してもらうか、端末の設定を JPEG にしてもらいます
2. パノラマ・魚眼の写真の区別 … 公式の案内で誤りやすいとされる画像です。ファイル名か撮影の区分で分け、見分けの結果に「人が見る」を付けます
3. 向きの確認 … 横倒しや逆さの写真は、見分けを誤りやすいとされています。撮影者に、向きを確かめてから入れてもらいます
4. 重複の除去 … 同じ写真が2枚入っていたら、1枚だけ見分けに渡します
5. 部屋の情報の付与 … 物件コード・部屋番号・設備の欄を、見分けの指示に添えます

1番目の HEIC は、最初の月に必ず出ます。 見分けに渡せなかった写真は、点検されていない写真として一覧のいちばん上に出します。 黙って飛ばすと、点検していない写真がそのまま入稿されます。

AIに処理させる

させるのは、1枚ずつ「何の場面か」「何が写り込んでいるか」「写りに問題があるか」を、写真の中の位置を添えて返すことだけです。

「読めるかどうか迷えば読める側に倒す」が大事です。 表札や車のナンバーは、見落としたときの損が、拾い過ぎたときの損よりずっと大きいからです。拾い過ぎた写真は担当者が1枚見て戻すだけで済みますが、見落とした写真はポータルサイトに出ます。

位置は「左上」「中央」のような9つの区分で返させ、正確な座標は求めません。 担当者がどのあたりを見ればよいかが分かれば足ります。

3行目を見落としやすいので注意してください。 何も言わないと、AIは親切に「表札：山田」「ナンバー：品川 300 あ 12-34」と書き写します。点検の一覧が、近所の人の名前と車のナンバーの一覧になってしまいます。 返させるのは「読める表札がある」という事実と位置だけです。

指示内容を固定する

あなたは賃貸の募集に使う部屋の写真を、掲載の前に点検する担当です。
渡された写真1枚について、写っている場面、写り込み、写りの問題を、
決められた JSON の形で返してください。

【見るもの】
1. 場面：exterior（外観）, entrance（エントランス）, common（共用部）,
   room（居室）, kitchen, bath（浴室）, toilet, washroom（洗面）,
   storage（収納）, balcony, view（眺望）, equipment（設備）,
   parking（駐車場）, other から1つ。
2. 写り込み：次の種類に当たるものをすべて挙げてください。
   - person ......... 人の顔・姿。鏡・窓ガラス・テレビの画面への映り込みを含む
   - nameplate ...... 表札、郵便受けや宅配ボックスの名前の札
   - license_plate .. 車やバイクのナンバープレート
   - personal_items . 家具・家電・衣類・ごみなど、備え付けでないと見える物
   - documents ...... 郵便物、掲示板の掲示、貼り紙、書類
   - neighbor_view .. 窓の外に、ほかの建物の部屋の中が見える
   - equipment_tool . 三脚、撮影者の指、作業の道具
3. 写り：dark（暗い）, tilted（傾き）, blurred（ぼけ）, backlit（逆光）,
   rotated（横倒し・逆さ）。それぞれ strong か weak。

【位置の書き方】
写真を縦横3つずつに分け、top_left, top_center, top_right, middle_left,
center, middle_right, bottom_left, bottom_center, bottom_right から選んでください。

【厳守事項】
- 表札の名前、ナンバープレートの文字、書類の中身は書き写さないでください。
  readable に true か false を入れるだけにしてください。
- 文字が読めるかどうか迷ったら readable は true にしてください。
- 写り込みかどうか迷ったものも挙げ、uncertain を true にしてください。
  迷ったものを省かないでください。
- 写っている人が誰かを推測しないでください。
- 写真を加工する方法や、掲載してよいかどうかは書かないでください。
- 部屋の傷・汚れ・設備の状態の良し悪しは書かないでください。
- 写真に写っていないことを、書かないでください。
- 部屋の写真でない（書類の写真、真っ暗な写真など）と判断したら、
  scene を other にし、note にその旨を書いてください。

【部屋の情報】{room_info}

「書き写さない」を最初の厳守事項に置いているのは、第7章の「させないこと」の3行目のためです。 書き写さないことを言わずに「表札があるか見て」とだけ頼むと、ほぼ必ず名前が結果に入ります。readable という真偽の項目だけをスキーマに置き、名前を入れる欄そのものを作らないのも同じ理由です。

「迷ったら挙げる」を2か所に書いているのは、何も言わないと確信の持てるものだけが返るからです。 窓の奥の小さな人影やぼやけたナンバーこそ、担当者に見てほしいものです。

出力形式を固定する

1枚ごとに、次の形の JSON を受け取ります。

{
  "photo_id": "R-1024-305_07.jpg",
  "scene": "parking",
  "findings": [
    { "type": "license_plate", "readable": true, "position": "bottom_right",
      "uncertain": false, "note": "手前の車の後ろのナンバー" },
    { "type": "nameplate", "readable": false, "position": "top_left",
      "uncertain": true, "note": "隣の建物の門柱に札のような物" }
  ],
  "quality": [
    { "type": "tilted", "level": "weak" }
  ],
  "note": ""
}

findings と quality は、何も無ければ空の配列にします。 スキーマで必須にしておき、項目そのものが抜けた結果を「何も無かった」と取り違えないようにします。

Google Apps Script は、この結果と掲載の基準から、写真の区分を決めます。

区分が2つ以上に当たったら、上の行を優先します。 撮り直すなら、隠す必要はありません。

部屋ごとには、場面の数を数えて撮り漏れを出します。

【部屋】R-1024 305号室（1LDK）　撮影者：協力会社 B
【写真】26枚　そのまま使える 21／隠してから使う 2／撮り直す 2／人が見る 1
【撮り漏れ】washroom（台帳：独立洗面台あり）
【依頼の下書き】
B様　R-1024 305号室の写真についてお願いです。
・07 駐車場：ぼかしをこちらで入れます（対応不要）
・12 居室：窓に撮影の方が映っています。角度を変えて撮り直しをお願いします
・19 浴室：暗いため、照明をつけて撮り直しをお願いします
・洗面台の写真が見当たりません。追加をお願いします

こう分けるのは、AIの結果と会社の基準を別々に持つためです。 掲載の基準が変わっても、直すのは区分の表だけで、過去の写真を見分け直す必要はありません。

システムへ連携する

写真フォルダには書き込まず、写真を動かすこともしません。 区分は点検の一覧に書くだけにします。

ポータルサイトへの入稿にはつなぎません。 「そのまま使える」写真を自動で入稿する作りにすると、AIが見落とした写り込みが、人が一度も見ないまま公開されます。

人が確認する

人が開くのは、「隠してから使う」「撮り直す」「人が見る」の写真だけです。 「そのまま使える」の写真は、一覧で場面と枚数を流し見ます。

1. 「人が見る」を先に見る … 迷ったものです。多くは何でもない影や模様ですが、窓の奥の人影もここに入ります
2. 「隠してから使う」を見て、ぼかしを入れる … 位置を見て、その部分だけをぼかします。部屋の壁や設備にかからないようにします
3. 「撮り直す」を見て、依頼の下書きを直す … 本当に撮り直しが要るかを確かめます。暗さの weak を strong と判断していたら、撮り直しをやめます
4. 撮り漏れを見て、台帳の設備が正しいかを確かめる … 台帳の誤りで撮り漏れが出ていることがあります
5. 区分を覆したら記録する … どの写真の、どの区分を、どちらに変えたかを残します

「そのまま使える」の写真も、入稿の前に縮小表示で全部を一度は見ます。 AIの見落としを止める最後の段です。

目標は、200室をならして1室3分です。

例外に対処する

4行目を見落とさないでください。 拒否や途中で切れた結果を JSON として読もうとすると、スクリプトが止まるか、空の findings として「そのまま使える」に入ります。 公式の案内でも、拒否は解析の前に確かめるよう書かれています。

記録を残す

• 部屋ごとの点検の日時と、点検した写真の一覧
• 1枚ごとの AI の結果の JSON（表札やナンバーの文字は入っていない）
• 区分と、そのとき使った掲載の基準の版
• 人が区分を覆した記録 … どの写真の、どの区分を、どちらに変えたか
• 撮影者への依頼と、撮り直しの写真が入った日時
• 撮影者ごとの「撮り直す」の数と、理由の内訳

4つ目の記録で、基準とAIのずれが分かります。 「そのまま使える」から引き上げた写真があれば、AIの見落としの型として、指示の例に足します。 最後の行は、撮り方の手引きを撮影者と見直す材料になります。