🤲 🎪 ⛹🏻 LocoLaser：アプリケーションをGoogleスプレッドシートに翻訳する 👨🏾‍🤝‍👨🏼 👩🏼‍🤝‍👩🏻 🚙

実際には、AndroidとiOSで、場合によってはWindows Phoneですぐにアプリケーションをリリースする必要があります。この場合、一部の開発者はローカライズの問題を事前に解決し、各プラットフォームを個別に翻訳します。同意する、最高の旅行ではありません。この問題を解決することを決めた当時、ネットワーク上で、Googleスプレッドシートから文字列リソースをダウンロードするためのユーティリティを見つけることはすでに可能でしたが、それらのほとんどは少なくとも不器用に見えました。私は絶対にこの状況が好きではありませんでした。その結果、LocoLaserが誕生しました-使いやすく、しかし非常にスマートなJavaのユーティリティです。数年の間、私はそれを仕事のプロジェクトでのみ使用していました。この間、彼女はなんとか豊富な機能を成長させることができ、今では一般に公開する準備ができています。

この記事では、LocoLaserとは何か、それをプロジェクトに統合する方法について説明します。まず、ユーティリティの機能を見てから、Android用のGradleプラグインやiOS用のBashスクリプトなど、より具体的なものに進みます。私は時々同じことをするのに十分な怠zyなプログラマーなので、初期セットアップの後、必要なときに必要なタスクを起動するだけで済むようにすべてが行われます。翻訳者にとって、翻訳は非常にシンプルに見えます。Googleテーブルを行と共有し、適切な列に翻訳を入力します。言語を追加する必要がある場合は、新しい言語で別の列を追加するだけです。 Googleスプレッドシートを使用すると、表を編集するアクセス権を個別に設定できるため、各翻訳者はそれぞれの言語の列にのみアクセスできます。

警告
記事の公開以降、ライブラリにはいくつかの重要な変更が加えられており、この記事に記載されているいくつかの点はもはや関係ありません。この記事の最後にリストされているリポジトリーで最新の指示と例を見つけることができます。

構成ファイル

しかし、ユーティリティに戻ります。あまりにも単純化されているため、それ自体は通常のjarファイルです。 Bintrayリポジトリからダウンロードできます。ユーティリティを起動する最も簡単な方法は、コンソールから実行することです。コンソールコマンドは次のようになります。

java -jar loco-laser-google.jar localization_config.json

備考1
コマンドを実行するには、マシンにJavaをインストールする必要があります。

備考2
繰り返しますが、プロジェクトでユーティリティを使用するためにjarを直接ダウンロードする必要はありません。これらの目的のために、既製のスクリプトとプラグインがあります。

コマンドの実行後、対応するリソースファイルが作成され、必要なフォルダーに配置されます。構成ファイルへのパスを最初のパラメーターとして渡す必要があります。上記の例では、これはファイル"localization_config.json"です。インポートとエクスポートのすべての複雑な設定を担当するのは彼です。ファイルは、たとえば次のように見えるテキストJSONです。

 { "platform": "android", "source": { "id":"1JZxUcu30BjxLwHg12bdHTxjDgsGFX9HA9zC4Jd8cuUM", "column_key":"key", "column_locales":["base", "ru"] } }

この例には、実行する最小限のパラメーターが含まれています。それらの意味を見てみましょう。

"platform"パラメーターは、インポートが実行されるプラットフォームを示します。 "android"と"ios"の2つのオプションのいずれかを使用できます（Windows Phoneはまだサポートされていませんが、これは時間の問題です）。形式に加えて、プラットフォームは、リソースを含むファイルの場所、それらの名前、および一時ファイルを保存する場所を担当します。

"source"パラメーターはJSONオブジェクトです。その内容は、行がどこでどのようにロードされるかを担当します。パラメータの最小セットは、 "column_key" "id" 、 "column_key" 、および"column_locales"です。

"source.id"識別子はGoogleテーブルIDである必要があります。この識別子を見つけるには、テーブルのURLを調べる必要があります。 docs.google.com/spreadsheets/d/1JZxUcu30BjxLwHg12bdHTxjDgsGFX9HA9zC4Jd8cuUMのようになります。この例では、識別子は"1JZxUcu30BjxLwHg12bdHTxjDgsGFX9HA9zC4Jd8cuUM"です。ちなみに、リンクはクリック可能であり、その上にテーブルの実際の例を見ることができます。

残りのパラメーターでは、すべてが非常に単純です。 "source.column_key"にはキーを持つ列の名前が含まれ、 "source.column_locales"値を持つ列名の配列が含まれます。列名もロケールです。 "base"という単語"base" 、ベースロケール用に予約されています。

ここで、少し余談をして、テーブルの構造を決定すると同時に、列名が何であるかを整理する価値があります。簡単な場合、LocoLaserは最初の「取り消し線」の行を列名のある行として扱います。「取り消し線は他に何ですか？」と尋ねます。実際、表の最初の列は公式の目的で使用されています。現時点では、最初の列に"-"追加して行を「消す」ことができます。取り消し線は完全に無視され、ローカライズには参加しません。上記のリンクを使用してテーブルを見ると、「人間」の見出しを持つ最初の行が「取り消し線」であり、テーブルの装飾要素にすぎないことがわかります。また、リソースを使用して行を「削除」することもできます。たとえば、行がどこでも使用されていない場合でも、削除するのは残念です。

パラメータの全リスト

上記のパラメータは、ユーティリティが機能するのに十分です。ただし、他にもあります。それぞれを詳細に説明するのではなく、表の形式で完全なリストのみを提供します。

出所

パラメータ	種類	説明
`id`	ひも	GoogleスプレッドシートのスプレッドシートID。テーブルURLにはこの識別子が含まれています（https://docs.google.com/spreadsheets/d/sheet_id）。必須です。
`column_key`	ひも	キー列の名前。必須です。
`column_locales`	文字列配列	値を持つ列名の配列。列名もロケールです。基本ロケールの場合、 `"base"`という名前の列を使用します。必須です。
`column_quantity`	ひも	定量的な値を持つ列の名前。テーブル内のセルには、次のいずれかの値が含まれている必要があります： `zero` 、 `one` 、 `two` 、 `few` 、 `many` 、 `other` 。空の文字列はその他として扱われます。オプションのパラメーター。デフォルトでは、定量値は使用されません。
`column_comment`	ひも	コメント列の名前。オプションのパラメーター。デフォルトでは、コメントはリソースファイルに書き込まれません。
`worksheet_title`	ひも	Google Sheetテーブル内のシートの名前。オプションのパラメーター。デフォルトでは、最初のシートが使用されます。
`credential_file`	ひも	OAuth認証の資格情報を含むファイルへのパス。相対パスを使用する場合、ファイルへのパスは作業ディレクトリに相対的です。オプションのパラメーター。
`type`	ひも	データソースのタイプ。 `"googlesheet"`必要が`"googlesheet"`ます。オプションのパラメーター。ただし、構成ファイルとユーティリティが同じソースタイプで機能していることを確認する場合は、そのタイプを指定する必要があります。

プラットフォーム
前に言ったように、プラットフォームはそれに固有のいくつかのパラメーターを設定します。上記のようにプラットフォームを文字列としてではなく、JSONオブジェクトとして定義すると、これらのパラメーターを変更できます。このオブジェクトの可能なプロパティのリストは次のとおりです。

パラメータ	種類	説明
`type`	ひも	プラットフォームのタイプ。可能な値は、 `"android"`または`"ios"`です。必須です。
`res_name`	ひも	拡張子なしのリソースファイル名。拡張子は、ファイルの種類に応じて選択されます。オプションのパラメーター。デフォルト値： Android- `"strings"` iOS- `"Localizable"`
`res_dir`	ひも	リソースディレクトリへのパス。オプションのパラメーター。デフォルト値： Android- `"./src/main/res/"` iOS- `"./"`
`temp_dir`	ひも	一時ファイルを保存するディレクトリへのパス。オプションのパラメーター。デフォルト値： Android- `"./build/tmp/"` iOS- `"../DerivedData/LocoLaserTemp/"`

重要！
すべての相対パスは、作業ディレクトリに相対的です。デフォルトでは、構成ファイルのディレクトリが作業ディレクトリとして使用されます。

その他のパラメーター
構成には、プラットフォームとソースに加えて、さらにいくつかのパラメーターが含まれる場合があります。それらはすべて結果に大きく影響します。

パラメータ	種類	説明
`work_dir`	ひも	作業フォルダーへのパス。すべての相対パスは、このフォルダーに相対的です。デフォルトは構成ファイルのディレクトリです。
`force_import`	ブール値	ユーティリティは、最後の実行時のリソースの状態を記憶し、不必要な必要なしにインポートを開始しないようにします。これを無視して常に完全にインポートするには、 `force_import`を`true`に設定し`true` 。デフォルト値はfalseです。
`conflict_strategy`	ひも	プラットフォームリソースとGoogleスプレッドシートのリソースを組み合わせる際の競合を解決する方法を定義します。 3つのオプションがあります。 `remove_platform`ローカルプラットフォームリソースを削除して、Googleスプレッドシートのリソースに完全に置き換えます。 `keep_new_platform`プラットフォーム行がGoogleシートにない場合は保存します。 `export_new_platform`新しいプラットフォーム行を保存し、Google `export_new_platform`シートにアップロードします。デフォルト値は`keep_new_platform`です。
`duplicate_comments`	ブール値	`duplicate_comments = false`場合、このコメントがローカライズされた文字列と等しい場合、コメントはリソースファイルに追加されません。デフォルト値は`false`です。
`delay`	長い	次のローカライズまでの最小時間を定義する分単位の時間。ローカリゼーションは、delayパラメーターで指定されているよりも頻繁に実行されません。 `force_import`使用される`force_import`遅延は無視されます。

duplicate_commentsパラメーターは、基本ロケールをコメントとして使用する場合に特に役立ちます。この場合、ローカライズされたリソースには常にベース言語（通常は英語）のテキスト付きのコメントがあり、ベースリソースにはコメントがありません。この場合、これらは文字列の値を繰り返し、余分です。

duplicate_comments = falseのAndroidリソースの例

/values/strings.xml

 <?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">LocoLaser example</string> <string name="screen_main_app_description">This is example application of how to use the LocoLaser.</string> <string name="screen_main_plural_example_title">Plural string examples</string> </resources>

/values-ru/strings.xml

 <?xml version="1.0" encoding="utf-8"?> <resources> /* LocoLaser example */ <string name="app_name">LocoLaser </string> /* This is example application of how to use the LocoLaser. */ <string name="screen_main_app_description">     LocoLaser.</string> /* Plural string examples */ <string name="screen_main_plural_example_title"> Plural </string> </resources>

カスタマイズされたlocalization_config.jsonの設定例

 { "platform": { "type":"android", "res_name":"strings_intro" }, "source": { "type":"googlesheet", "id":"1JZxUcu30BjxLwHg12bdHTxjDgsGFX9HA9zC4Jd8cuUM", "column_key":"key", "column_locales":["base", "ru"], "column_comment":"base", “worksheet_title”:”Strings intro” }, "force_import":true, "conflict_strategy":”keep_new_platform”, "delay":60, }

コンソール引数

コンソールからローカライザーを起動すると、いくつかの構成パラメーターを変更できます。これを行うには、適切な引数を追加します。 重要：構成ファイルへのパスは常に最初に指定されます。残りの引数の順序は重要ではありません。

引数	説明
`--force`または`--f`	フラグ。 `"force_import = true"`設定し`"force_import = true"`
`-cs string conflict strategy`	`"conflict_strategy"`プロパティをオーバーライドします
`-delay long delay`	`"delay"`プロパティをオーバーライドします

コマンド例

 java -jar loco-laser-google.jar localization_config.json --f -cs keep_new_platform

AndroidおよびGradleプラグイン

AndroidでLocoLaserを使用する場合は、特別なGradleプラグインを使用する必要があります。彼は、プロジェクトにいくつかのタスクを追加し、 「ローカリゼーション」グループに統合しました。プラグインの接続には、「クラシック」と「代替」の2つのオプションがあります。

プラグインを接続する古典的な方法

ルートプロジェクトの"build.gradle"ファイルを開き、次の行を追加します。

 buildscript { repositories { maven { url "https://plugins.gradle.org/m2/" } } dependencies { classpath "gradle.plugin.ru.pocketbyte.locolaser:plugin:1.0.1" } }

その後、アプリケーションモジュールのファイル"build.gradle"開き、ファイルの先頭に1行追加します。

 apply plugin: "ru.pocketbyte.locolaser"

プラグインを接続する代替方法

この方法は、Gradleバージョン2.1以降のプロジェクトに適しており、いわゆる「インキュベーション」機能を使用します（ご自身の責任で使用してください、Gradleチームは警告しています）。ルート"build.gradle"何かを書く必要はありません。必要な"build.gradle"モジュールを開き、ファイルの一番上に次の行を追加します

 plugins { id "ru.pocketbyte.locolaser" version "1.0.1" }

ここでも、行が一番上にあることに注意してください。彼女の前には他に何も置かないでください。そうでない場合、プロジェクトは同期されません。

上記のいずれかの方法でプラグインを接続した後、同じファイルに次の依存関係を追加します。

 dependencies { ... localize 'ru.pocketbyte.locolaser:locolaser-mobile-googlesheet:1.1.+' }

これで、構成ファイルをアプリケーションモジュールのフォルダーに配置するだけで、作業を開始できます。デフォルトでは、プラグインは設定ファイルとして"localize_config.json"というファイルを使用します。プロジェクトが同期されると、 「ローカリゼーション」グループがタスクのGradleリストに表示されます。これには3つのタスクが含まれています。

localize-標準パラメーターでLocoLaserを開始します。
localizeForce - "--force" --force "--force"フラグを使用してLocoLaserを起動します。
localizeExportNew-フラグ"--force"および"conflict_strategy" = "export_new_platform"ます。

すべてのビルドでローカライズを開始する場合は、 preBuildタスクに依存関係を追加します。

 afterEvaluate { preBuild.dependsOn project.tasks.localize }

GitHubのAndroidプロジェクトの例： github.com/PocketByte/locolaser-android-example
Gradleプラグインを使用。ローカリゼーションはビルドプロセスに組み込まれています。

iOSアプリケーションのローカライズ

Androidとは異なり、iOSにはGradleのような強力なビルドシステムがないため、回避策を使用する必要があります。多くの回避策があり、iOSイデオロギーに完全に適合するからです。構成ファイルをソースフォルダーに保存することをお勧めします。通常、このフォルダーの名前はプロジェクトの名前と一致します（これがデフォルト値を使用できる唯一の場所です）。

したがって、構成ファイルを作成し、ソースフォルダーに配置しました。使い方は？ユーティリティのアーティファクトはリモートMavenリポジトリにあるため、依存関係管理システムをシミュレートするbashスクリプトを作成する方法を試しました。ここにあります：

localize.command

 GROUP="ru/pocketbyte/locolaser" ARTIFACT="locolaser-mobile-googlesheet" VERSION="1.1.1" CONFIG_FILE="localization_config.json" cd "`dirname \"$0\"`" ARTIFACTS_DIR="../DerivedData/LocoLaserTemp/artifacts/$GROUP/" mkdir -p $ARTIFACTS_DIR ARTIFACT_FILE="$ARTIFACTS_DIR$ARTIFACT-$VERSION.jar" if [ -f $ARTIFACT_FILE ] then echo "Artifact already downloaded" else ARTIFACT_URL="https://bintray.com/pocketbyte/maven/download_file?file_path=$GROUP/$ARTIFACT/$VERSION/$ARTIFACT-$VERSION.jar" echo "Loading: $ARTIFACT_URL" curl -L -o $ARTIFACT_FILE $ARTIFACT_URL if [ $? -eq 0 ] then echo "Artifact downloaded" else exit $? fi fi java -jar $ARTIFACT_FILE $CONFIG_FILE

このスクリプトは、リモートMavenリポジトリーからjarファイルをダウンロードし、 "../DerivedData/LocoLaserTemp/artifacts/"フォルダーに配置してから実行するために起動します。構成ファイルとして、Androidのように"localize_config.json"という名前のファイル"localize_config.json"されます。決定は非常に失礼です。使用するアーティファクトのバージョンを正確に示す必要があります。ただし、タスクに完全に対応しており、jarプロジェクトにユーティリティファイルを保存する必要はありません。相対パスから推測できるように、スクリプトは構成ファイルと同じフォルダーに保存する必要があります。私のプロジェクトには、 localize.command 、 localizeForce.command 、およびlocalizeExportNew.commandのようなスクリプトがいくつかあります。これらのコマンドはすべて、上記のGradleプラグインのタスクを繰り返します。

すべてのビルドでローカライズを実行する場合は、適切なRun scripを追加します。

実行スクリプトは、 ターゲットの依存関係フェーズの直後に実行する必要があります。これは重要です。たとえば、 バンドルリソースのコピーフェーズの後に新しい行がインポートされると、次のビルドでのみ目的の結果が遅れて表示されるためです。

GitHubのiOSプロジェクトの例： github.com/PocketByte/locolaser-ios-example
使用されたbashスクリプト。ローカリゼーションはビルドプロセスに組み込まれています。

Windows Phoneおよびその他のプラットフォーム

残念ながら、このプラットフォームでの開発の経験はまったくありません。現在働いている組織では、Windows Phoneアプリケーションの開発は長い間行われていません。この記事をWindows Phoneハブに投稿したことを心からおizeび申し上げます。ただし、Windows Phone開発者の注意を引くためのより良い方法は見つかりませんでした。あなたが豊富な経験を持つWindows Phone開発者であり、このトピックについて教えてほしいことがあれば、私に連絡してください。また、読者の1人が他のプラットフォームやサービスでLocoLaserを使用することについて考えているなら、書くことをためらわないでください。私は提案を受け入れます。

資格証明ファイル

Googleスプレッドシートにアクセスするには、OAuth認証を行う必要があります。パラメーター"source.credential_file"構成ファイルに設定されていない場合、ローカライザーが起動すると、Google認証ページのあるブラウザーが自動的に開きます。認証に成功すると、ユーティリティは作業を続行します。次回、このテーブルにログインする必要はありません。

上記のアプローチはユーザーの介入を必要とするため、ローカライズプロセスが自動的に行われる状況には適していません。プロセスが常に自動的に実行されるようにするには、 credential_file指定する必要がありcredential_file 。資格情報ファイルとしては、Googleサービスアカウントファイルが適しています。 Google Developers Consoleで作成するには、次を実行する必要があります。

アプリケーション用にまだ作成されていない場合は、新しいプロジェクトを作成します。
サービスアカウントのリストを開きます。プロジェクトを選択するように求められたら、アプリケーションのプロジェクトを選択します。
[ サービスアカウントの作成]をクリックします。
[ サービスアカウントの作成]ウィンドウで、新しいサービスアカウントの名前を入力し、[ 新しい秘密キーの作成]フラグを有効にして、JSONキータイプを選択します。アカウントの役割を選択する必要はありません。 作成をクリックします。

サービスアカウントが作成され、その後、秘密キーファイルが自動的にダウンロードされます。このファイルへのパスは、パラメーター"source.credential_file"として指定する必要があります。サービスアカウントがGoogleスプレッドシートにアクセスできるようにするには、以前に作成したサービスアカウントと共有する必要があります。共有する場合、サービスアカウント識別子を電子メールとして指定します。この識別子は、サービスアカウントのリストで確認するか、ダウンロードしたキーファイルで確認できます。

サービスキーファイルの例

 { "type": "service_account", "project_id": "myapp-1086", "private_key_id": "b67c2edcc47c7053c035d8681c8eb7e9f4d90c09", "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO\nw+tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji\nM0IIA+vi+dgHXwHfCPhS9d85xZ73fuqFaj29iru+pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er+bO4DE\n8Ecpripfd/e7qq89WcGu1H8S+3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo\nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3/xY5hHTxwtS8yJxoUgTVEfgNB\nDwzNrZSCVEMCoBAIYl6rWGITgNaR0+FLuP+kjZw\nHsLdkU8173J3nhuYhxo7N90BhO08lquIQ7bJAoGBAKLz\nVRxRdFlcdlMNK34K0dkVh4E4Y8K+9oQWqQeKIrHfWpuSr8CH5q+Dpek8qVGKPnFm\n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz\nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z//QfpyEZ2PUvpCNVVpeRuMmUhv\nu5rSLa0G+C97/XIGz/O/1ME9WXU6ZNRwwDkSDw6L7AIrXY8V+8pIRL9e0ks4Uw/A\n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL/h8tfhXPel\nwQot9dM8P4CmQNR/fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO\nMKl1PjiD+YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp\nagQv22+6STL+0s1haOxyfbi1jIzXvzh47yij6+v7WEIdNj45WV9kpcFTi2oUXURt\nEi3WskYTijYGbDNQmpG2kmY\nDz0KdeTFJxsnFstTT/VozEGvNIHf+8PhKv0123dBFuqSgBD5SFHDp3tQ2IzC81Jm\n5FJLldk3Hw1QRh6+WiEJBTX6nFU4DB5tVXKhbPOvhqYwI/CUYWWbVBQCQgqURcyr\nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk/Z1E7iDl/SDfYSSD70wAgGblH2\nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN+OtxvHfqqKAkFO4Ijz1+b6R\n3/t4P7KTRhOqaHTZ7zjlu/kbsKzc9casRY+lqybp4/c4jNaGBklG6Vmu96E9wKBgEFPsRe88v/UaAV213Jlw0hdYE9I19yW6z7OSl+Q0dflDbLO5cRs\nTeHlh+9zhzThLVYf79vvwrO4klXm9Mv/7sa/uQ54GK7IkXVklSxUoZpThoOme5hT\n+8ScgJSnyqEpwFQjaslbNBUxtpc9IA2bseP1S7aCVDfZtEp7rHqOFZTvSgol5YD/AoGAdIMNKvg0IiS2xcIEbyHa\nPTNrUfpHeJk/P+Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc\ngWesc2RLPIG8+so1TpG1F62+tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7\niuSVbY0UnpxGnqzo9TBAYS4=\n-----END PRIVATE KEY-----\n", "client_email": "localizator@myapp-1086.iam.gserviceaccount.com", "client_id": "704739729071909788554", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/localizator%40myapp-1086.iam.gserviceaccount.com" } KEYを----- \ nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO \ NW + tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji \ nM0IIA + VI + dgHXwHfCPhS9d85xZ73fuqFaj29iru + pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er + bO4DE \ n8Ecpripfd / e7qq89WcGu1H8S + 3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo \ nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3 / xY5hHTxwtS8yJxoUgTVEfgNB \ nDwzNrZSCVEMCoBAIYl6rWGITgNaR0 + FLUP + kjZw { "type": "service_account", "project_id": "myapp-1086", "private_key_id": "b67c2edcc47c7053c035d8681c8eb7e9f4d90c09", "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO\nw+tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji\nM0IIA+vi+dgHXwHfCPhS9d85xZ73fuqFaj29iru+pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er+bO4DE\n8Ecpripfd/e7qq89WcGu1H8S+3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo\nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3/xY5hHTxwtS8yJxoUgTVEfgNB\nDwzNrZSCVEMCoBAIYl6rWGITgNaR0+FLuP+kjZw\nHsLdkU8173J3nhuYhxo7N90BhO08lquIQ7bJAoGBAKLz\nVRxRdFlcdlMNK34K0dkVh4E4Y8K+9oQWqQeKIrHfWpuSr8CH5q+Dpek8qVGKPnFm\n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz\nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z//QfpyEZ2PUvpCNVVpeRuMmUhv\nu5rSLa0G+C97/XIGz/O/1ME9WXU6ZNRwwDkSDw6L7AIrXY8V+8pIRL9e0ks4Uw/A\n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL/h8tfhXPel\nwQot9dM8P4CmQNR/fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO\nMKl1PjiD+YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp\nagQv22+6STL+0s1haOxyfbi1jIzXvzh47yij6+v7WEIdNj45WV9kpcFTi2oUXURt\nEi3WskYTijYGbDNQmpG2kmY\nDz0KdeTFJxsnFstTT/VozEGvNIHf+8PhKv0123dBFuqSgBD5SFHDp3tQ2IzC81Jm\n5FJLldk3Hw1QRh6+WiEJBTX6nFU4DB5tVXKhbPOvhqYwI/CUYWWbVBQCQgqURcyr\nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk/Z1E7iDl/SDfYSSD70wAgGblH2\nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN+OtxvHfqqKAkFO4Ijz1+b6R\n3/t4P7KTRhOqaHTZ7zjlu/kbsKzc9casRY+lqybp4/c4jNaGBklG6Vmu96E9wKBgEFPsRe88v/UaAV213Jlw0hdYE9I19yW6z7OSl+Q0dflDbLO5cRs\nTeHlh+9zhzThLVYf79vvwrO4klXm9Mv/7sa/uQ54GK7IkXVklSxUoZpThoOme5hT\n+8ScgJSnyqEpwFQjaslbNBUxtpc9IA2bseP1S7aCVDfZtEp7rHqOFZTvSgol5YD/AoGAdIMNKvg0IiS2xcIEbyHa\nPTNrUfpHeJk/P+Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc\ngWesc2RLPIG8+so1TpG1F62+tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7\niuSVbY0UnpxGnqzo9TBAYS4=\n-----END PRIVATE KEY-----\n", "client_email": "localizator@myapp-1086.iam.gserviceaccount.com", "client_id": "704739729071909788554", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/localizator%40myapp-1086.iam.gserviceaccount.com" } \ n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz \ nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z // QfpyEZ2PUvpCNVVpeRuMmUhv \ nu5rSLa0G + C97 / XIGz / O / 1ME9WXU6ZNRwwDkSDw6L7AIrXY8V + 8pIRL9e0ks4Uw / A \ n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL / h8tfhXPel \ nwQot9dM8P4CmQNR / fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO \ nMKl1PjiD + YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp \ nagQv22 + 6STL + 0s1haOxyfbi1jIzXvzh47yij6 + v7WEIdNj45WV9kpcFTi2oUXURt \ { "type": "service_account", "project_id": "myapp-1086", "private_key_id": "b67c2edcc47c7053c035d8681c8eb7e9f4d90c09", "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO\nw+tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji\nM0IIA+vi+dgHXwHfCPhS9d85xZ73fuqFaj29iru+pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er+bO4DE\n8Ecpripfd/e7qq89WcGu1H8S+3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo\nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3/xY5hHTxwtS8yJxoUgTVEfgNB\nDwzNrZSCVEMCoBAIYl6rWGITgNaR0+FLuP+kjZw\nHsLdkU8173J3nhuYhxo7N90BhO08lquIQ7bJAoGBAKLz\nVRxRdFlcdlMNK34K0dkVh4E4Y8K+9oQWqQeKIrHfWpuSr8CH5q+Dpek8qVGKPnFm\n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz\nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z//QfpyEZ2PUvpCNVVpeRuMmUhv\nu5rSLa0G+C97/XIGz/O/1ME9WXU6ZNRwwDkSDw6L7AIrXY8V+8pIRL9e0ks4Uw/A\n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL/h8tfhXPel\nwQot9dM8P4CmQNR/fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO\nMKl1PjiD+YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp\nagQv22+6STL+0s1haOxyfbi1jIzXvzh47yij6+v7WEIdNj45WV9kpcFTi2oUXURt\nEi3WskYTijYGbDNQmpG2kmY\nDz0KdeTFJxsnFstTT/VozEGvNIHf+8PhKv0123dBFuqSgBD5SFHDp3tQ2IzC81Jm\n5FJLldk3Hw1QRh6+WiEJBTX6nFU4DB5tVXKhbPOvhqYwI/CUYWWbVBQCQgqURcyr\nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk/Z1E7iDl/SDfYSSD70wAgGblH2\nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN+OtxvHfqqKAkFO4Ijz1+b6R\n3/t4P7KTRhOqaHTZ7zjlu/kbsKzc9casRY+lqybp4/c4jNaGBklG6Vmu96E9wKBgEFPsRe88v/UaAV213Jlw0hdYE9I19yW6z7OSl+Q0dflDbLO5cRs\nTeHlh+9zhzThLVYf79vvwrO4klXm9Mv/7sa/uQ54GK7IkXVklSxUoZpThoOme5hT\n+8ScgJSnyqEpwFQjaslbNBUxtpc9IA2bseP1S7aCVDfZtEp7rHqOFZTvSgol5YD/AoGAdIMNKvg0IiS2xcIEbyHa\nPTNrUfpHeJk/P+Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc\ngWesc2RLPIG8+so1TpG1F62+tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7\niuSVbY0UnpxGnqzo9TBAYS4=\n-----END PRIVATE KEY-----\n", "client_email": "localizator@myapp-1086.iam.gserviceaccount.com", "client_id": "704739729071909788554", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/localizator%40myapp-1086.iam.gserviceaccount.com" } n5FJLldk3Hw1QRh6 + WiEJBTX6nFU4DB5tVXKhbPOvhqYwI / CUYWWbVBQCQgqURcyr \ nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk / Z1E7iDl / SDfYSSD70wAgGblH2 \ nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN + OtxvHfqqKAkFO4Ijz1 + B6R \ N3 / t4P7KTRhOqaHTZ7zjlu / kbsKzc9casRY + lqybp4 / c4jNaGBklG6Vmu96E9wKBgEFPsRe88v / UaAV213Jlw0hdYE9I19yW6z7OSl + Q0dflDbLO5cRs \ nTeHlh + 9zhzThLVYf79vvwrO4klXm9Mv / 7sa / uQ54GK7IkXVklSxUoZpThoOme5hT \ N + { "type": "service_account", "project_id": "myapp-1086", "private_key_id": "b67c2edcc47c7053c035d8681c8eb7e9f4d90c09", "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO\nw+tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji\nM0IIA+vi+dgHXwHfCPhS9d85xZ73fuqFaj29iru+pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er+bO4DE\n8Ecpripfd/e7qq89WcGu1H8S+3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo\nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3/xY5hHTxwtS8yJxoUgTVEfgNB\nDwzNrZSCVEMCoBAIYl6rWGITgNaR0+FLuP+kjZw\nHsLdkU8173J3nhuYhxo7N90BhO08lquIQ7bJAoGBAKLz\nVRxRdFlcdlMNK34K0dkVh4E4Y8K+9oQWqQeKIrHfWpuSr8CH5q+Dpek8qVGKPnFm\n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz\nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z//QfpyEZ2PUvpCNVVpeRuMmUhv\nu5rSLa0G+C97/XIGz/O/1ME9WXU6ZNRwwDkSDw6L7AIrXY8V+8pIRL9e0ks4Uw/A\n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL/h8tfhXPel\nwQot9dM8P4CmQNR/fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO\nMKl1PjiD+YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp\nagQv22+6STL+0s1haOxyfbi1jIzXvzh47yij6+v7WEIdNj45WV9kpcFTi2oUXURt\nEi3WskYTijYGbDNQmpG2kmY\nDz0KdeTFJxsnFstTT/VozEGvNIHf+8PhKv0123dBFuqSgBD5SFHDp3tQ2IzC81Jm\n5FJLldk3Hw1QRh6+WiEJBTX6nFU4DB5tVXKhbPOvhqYwI/CUYWWbVBQCQgqURcyr\nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk/Z1E7iDl/SDfYSSD70wAgGblH2\nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN+OtxvHfqqKAkFO4Ijz1+b6R\n3/t4P7KTRhOqaHTZ7zjlu/kbsKzc9casRY+lqybp4/c4jNaGBklG6Vmu96E9wKBgEFPsRe88v/UaAV213Jlw0hdYE9I19yW6z7OSl+Q0dflDbLO5cRs\nTeHlh+9zhzThLVYf79vvwrO4klXm9Mv/7sa/uQ54GK7IkXVklSxUoZpThoOme5hT\n+8ScgJSnyqEpwFQjaslbNBUxtpc9IA2bseP1S7aCVDfZtEp7rHqOFZTvSgol5YD/AoGAdIMNKvg0IiS2xcIEbyHa\nPTNrUfpHeJk/P+Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc\ngWesc2RLPIG8+so1TpG1F62+tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7\niuSVbY0UnpxGnqzo9TBAYS4=\n-----END PRIVATE KEY-----\n", "client_email": "localizator@myapp-1086.iam.gserviceaccount.com", "client_id": "704739729071909788554", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/localizator%40myapp-1086.iam.gserviceaccount.com" } Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc \ ngWesc2RLPIG8 + so1TpG1F62 + tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7 \ niuSVbY0UnpxGnqzo9TBAYS4 = \ N ----- END PRIVATE KEY ----- \ n」は、 { "type": "service_account", "project_id": "myapp-1086", "private_key_id": "b67c2edcc47c7053c035d8681c8eb7e9f4d90c09", "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDJUV49mSQB2NSO\nw+tfQWq4pP63U4t7W8V6O6E7FABbYS5N4g35nRzVEj5NciqI27shHSKVrsl7U5ji\nM0IIA+vi+dgHXwHfCPhS9d85xZ73fuqFaj29iru+pTq9tuNieLDl60L04oCc1qQKBgQDLsMMnX2r9qkQw01H5L2WRB9R6er+bO4DE\n8Ecpripfd/e7qq89WcGu1H8S+3Jy49dBmN709vPvVcsGQx8mDdYdm4P0WPkKbgTo\nt12OA07uiY6Zn54rW5CXrjdoscPXB94AS2ps4M3/xY5hHTxwtS8yJxoUgTVEfgNB\nDwzNrZSCVEMCoBAIYl6rWGITgNaR0+FLuP+kjZw\nHsLdkU8173J3nhuYhxo7N90BhO08lquIQ7bJAoGBAKLz\nVRxRdFlcdlMNK34K0dkVh4E4Y8K+9oQWqQeKIrHfWpuSr8CH5q+Dpek8qVGKPnFm\n567XRUzJuLLYzbl2xj1HZWf8KbeTTnALKYg8Jz\nxXXvLlZl2OJ8Frr9ry1DEszPkwWwTQJg5bRG7Z//QfpyEZ2PUvpCNVVpeRuMmUhv\nu5rSLa0G+C97/XIGz/O/1ME9WXU6ZNRwwDkSDw6L7AIrXY8V+8pIRL9e0ks4Uw/A\n6ACYrlYMYYAIl79MNrUrizvF5KwxLiohHJ5KVpThGuRZDaidCPp9BL/h8tfhXPel\nwQot9dM8P4CmQNR/fMpytQSVk7vv95B2JHrt6QmIsQKBgQD9BJ8gfZUVhlxtuaWO\nMKl1PjiD+YKhz4rmIZUKM84xphsGYUBhH29s1zb98u9vlEnlx3bGUtDakNnjTDQp\nagQv22+6STL+0s1haOxyfbi1jIzXvzh47yij6+v7WEIdNj45WV9kpcFTi2oUXURt\nEi3WskYTijYGbDNQmpG2kmY\nDz0KdeTFJxsnFstTT/VozEGvNIHf+8PhKv0123dBFuqSgBD5SFHDp3tQ2IzC81Jm\n5FJLldk3Hw1QRh6+WiEJBTX6nFU4DB5tVXKhbPOvhqYwI/CUYWWbVBQCQgqURcyr\nUdRxAHyDrxKhNrmXXKAEwR0rDz2uGTQCfJ0Zyk/Z1E7iDl/SDfYSSD70wAgGblH2\nAAIQzeoPAgMBAAECggEAb7Trswhft3qmb1V9LEzzN+OtxvHfqqKAkFO4Ijz1+b6R\n3/t4P7KTRhOqaHTZ7zjlu/kbsKzc9casRY+lqybp4/c4jNaGBklG6Vmu96E9wKBgEFPsRe88v/UaAV213Jlw0hdYE9I19yW6z7OSl+Q0dflDbLO5cRs\nTeHlh+9zhzThLVYf79vvwrO4klXm9Mv/7sa/uQ54GK7IkXVklSxUoZpThoOme5hT\n+8ScgJSnyqEpwFQjaslbNBUxtpc9IA2bseP1S7aCVDfZtEp7rHqOFZTvSgol5YD/AoGAdIMNKvg0IiS2xcIEbyHa\nPTNrUfpHeJk/P+Frr1cmDHhGe1l0FWNg9EDlhItAW5EP15ubZPdWQRrV7RuydJlc\ngWesc2RLPIG8+so1TpG1F62+tsQ9lGSF5imiew1x7sQ3H0VIpGtSfTvSMep6fuE7\niuSVbY0UnpxGnqzo9TBAYS4=\n-----END PRIVATE KEY-----\n", "client_email": "localizator@myapp-1086.iam.gserviceaccount.com", "client_id": "704739729071909788554", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/localizator%40myapp-1086.iam.gserviceaccount.com" }

"client_email" -これはアカウント識別子です。

おわりに

繰り返しになりますが、ユーティリティアーキテクチャは、簡単に拡張または補完できるように設計されており、ソースとプラットフォームが独立して動作することに注意してください。たとえば、必要に応じて、ソースのリストを補足し、これに適したAPIを備えたデータベースまたはWebサービスをソースとして使用できます。そのため、Googleスプレッドシートに光が集まらず、「グーグル対策」の支持者は適切な解決策を見つけることができます。

また、この記事の執筆に協力してくれたInna（Foenix）にも感謝します。それがなければ、記事はそれほどわかりやすく、理解できません。インナ、アドバイスやコメントをありがとう。

これで終わります。時間をかけて私の創造に慣れてくれてありがとう。コメントであなたの意見、提案、批判を得ることができてうれしいです。そして、上矢印または下矢印を押すことを忘れないでください。それは私にとって非常に重要です。Habrコミュニティが私の仕事をどのように受け入れたかを知りたいです。

ソースへのリンク：

→ GitHubのLocoLaserソースコード
→ GitHubのGradleプラグインのソースコード
→ Androidの例
→ iOSの例

→ Bintrayへのリンク
→ サンプル表

LocoLaser：アプリケーションをGoogleスプレッドシートに翻訳する