gplay-metadata-sync

Google Play のメタデータ同期

Play ストアのメタデータやローカライズを更新または同期する必要がある場合に、このスキルを使用してください。

Fastlane のディレクトリ構造

fastlane/metadata/android/
├── en-US/
│   ├── title.txt
│   ├── short_description.txt
│   ├── full_description.txt
│   ├── video.txt
│   └── images/
│       ├── phoneScreenshots/
│       │   ├── 1.png
│       │   └── 2.png
│       ├── sevenInchScreenshots/
│       ├── tenInchScreenshots/
│       ├── tvScreenshots/
│       ├── wearScreenshots/
│       ├── icon.png
│       └── featureGraphic.png
├── es-ES/
│   ├── title.txt
│   └── ...
└── fr-FR/
    └── ...

Play ストアからメタデータをエクスポート

# Export all listings to Fastlane format
gplay sync export-listings \
  --package com.example.app \
  --dir ./fastlane/metadata/android

# Export images
gplay sync export-images \
  --package com.example.app \
  --dir ./fastlane/metadata/android

Play ストアにメタデータをインポート

# Validate before importing (offline check)
gplay validate listing \
  --dir ./fastlane/metadata/android \
  --locale en-US

# Import all listings
gplay sync import-listings \
  --package com.example.app \
  --dir ./fastlane/metadata/android

# Import images
gplay sync import-images \
  --package com.example.app \
  --dir ./fastlane/metadata/android

ローカルとリモートの比較

# See what would change
gplay sync diff-listings \
  --package com.example.app \
  --dir ./fastlane/metadata/android

メタデータの手動管理

すべての掲載情報を一覧表示

gplay listings list \
  --package com.example.app \
  --edit $EDIT_ID

特定のロケールを取得

gplay listings get \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US

掲載情報を更新

listings update は個別のフラグでロケールのすべてのフィールドを設定します（指定されていないフィールドはクリアされます）。部分更新には listings patch を使用してください。

gplay listings update \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US \
  --title "My Awesome App" \
  --short-description "A short description under 80 characters" \
  --full-description "A full description under 4000 characters..." \
  --video "https://www.youtube.com/watch?v=VIDEO_ID"

画像の管理

スクリーンショットをアップロード

gplay images upload \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US \
  --type phoneScreenshots \
  --file screenshot1.png

gplay images upload \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US \
  --type phoneScreenshots \
  --file screenshot2.png

画像の種類

• phoneScreenshots - スマートフォンのスクリーンショット（必須）
• sevenInchScreenshots - 7 インチタブレットのスクリーンショット
• tenInchScreenshots - 10 インチタブレットのスクリーンショット
• tvScreenshots - テレビのスクリーンショット
• wearScreenshots - Wear OS のスクリーンショット
• icon - アプリアイコン
• featureGraphic - フィーチャーグラフィック（1024x500）

画像を一覧表示

gplay images list \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US \
  --type phoneScreenshots

画像を削除

gplay images delete \
  --package com.example.app \
  --edit $EDIT_ID \
  --locale en-US \
  --type phoneScreenshots \
  --image IMAGE_ID \
  --confirm

アプリの詳細

アプリの詳細を取得

gplay details get \
  --package com.example.app \
  --edit $EDIT_ID

連絡先情報を更新

gplay details update \
  --package com.example.app \
  --edit $EDIT_ID \
  --contact-email [email protected] \
  --contact-phone "+1234567890" \
  --contact-website "https://example.com"

文字数制限

Google Play の制限に照らして検証してください。

フィールド	制限
タイトル	30 文字
短い説明	80 文字
詳細な説明	4000 文字

# Validate before upload
gplay validate listing \
  --dir ./fastlane/metadata/android \
  --locale en-US

ワークフローの例

メタデータ更新のワークフロー全体：

# 1. Export current metadata
gplay sync export-listings \
  --package com.example.app \
  --dir ./metadata

# 2. Edit files locally
vi ./metadata/en-US/full_description.txt

# 3. Validate changes
gplay validate listing \
  --dir ./metadata \
  --locale en-US

# 4. See what will change
gplay sync diff-listings \
  --package com.example.app \
  --dir ./metadata

# 5. Import changes
gplay sync import-listings \
  --package com.example.app \
  --dir ./metadata

複数ロケールの管理

新しいロケールを作成

1. 既存のロケールディレクトリをコピーします。

   cp -r fastlane/metadata/android/en-US fastlane/metadata/android/es-ES
   

2. すべてのテキストファイルを翻訳します。

3. インポートします。

   gplay sync import-listings \
     --package com.example.app \
     --dir ./fastlane/metadata/android
   

対応ロケール

Play Console のロケールコードを使用してください。

• en-US - 英語（米国）
• es-ES - スペイン語（スペイン）
• fr-FR - フランス語（フランス）
• de-DE - ドイツ語（ドイツ）
• ja-JP - 日本語（日本）
• など

ベストプラクティス

1. メタデータをバージョン管理に保存する - 変更を継続的に追跡します
2. インポート前に検証する - 文字数制限のエラーを検出します
3. 一貫した書式を使用する - スタイルガイドに従います
4. さまざまなデバイスでテストする - スクリーンショットは実際のアプリを反映するようにします
5. 定期的に更新する - 説明を最新の機能に合わせて保ちます
6. 適切にローカライズする - レビューなしで機械翻訳を使用しないでください