{"id":19623806,"url":"https://github.com/appleple/acms-google-sheets","last_synced_at":"2025-04-28T05:30:38.686Z","repository":{"id":66341120,"uuid":"129709331","full_name":"appleple/acms-google-sheets","owner":"appleple","description":"Google Sheets API と連携し、お問い合わせフォームなどで送信された内容を任意のGoogle スプレッドシートの最後の行に追記することができます。","archived":false,"fork":false,"pushed_at":"2024-09-17T06:46:08.000Z","size":79437,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-09-18T05:51:36.428Z","etag":null,"topics":["ablogcms","acms"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appleple.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-16T08:22:11.000Z","updated_at":"2024-09-17T06:46:10.000Z","dependencies_parsed_at":"2024-09-17T05:40:08.939Z","dependency_job_id":"b15f8cde-e26c-42b2-9c03-e2c556807222","html_url":"https://github.com/appleple/acms-google-sheets","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appleple%2Facms-google-sheets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appleple%2Facms-google-sheets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appleple%2Facms-google-sheets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appleple%2Facms-google-sheets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appleple","download_url":"https://codeload.github.com/appleple/acms-google-sheets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224096503,"owners_count":17255103,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ablogcms","acms"],"created_at":"2024-11-11T11:35:33.783Z","updated_at":"2024-11-11T11:35:35.194Z","avatar_url":"https://github.com/appleple.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google Sheets for a-blog cms\n\na-blog cms Ver.2.8.0 より拡張アプリ「Google Sheets」を利用できるようになります。 a-blog cms の拡張アプリ「[Google Sheets](https://www.google.com/sheets/about/)」を使うとお問い合わせフォームなどで送信された内容を任意の Google SpreadSheet の最後の行に追記することができます。\n\n## 動作環境\n\n- a-blog cms \u003e= 3.1.0\n- php \u003e= 7.2.5\n\n## ダウンロード\n\n[Google Sheets for a-blog cms](https://github.com/appleple/acms-google-sheets/raw/master/build/GoogleSheets.zip)\n\n## 下準備\n\n以下の 2 つのステップで a-blog cms と [Google Sheets](https://www.google.com/sheets/about/) を連携します。\n\n1. ClientID JSON の取得\n2. ClientID JSON を CMS 側に登録\n\n### ClientID JSON の取得\n\n\u003cimg src=\"./images/get_client_id.png\" /\u003e\n\nまずは、[Google API Console](https://console.developers.google.com/) にアクセスしてログインしてください。ログイン後、任意の名前でプロジェクトを作成します。 上の画像のように 1, 2 の手順でプロジェクトを新規作成できます。\n\n\u003cimg src=\"./images/project_selection.png\" /\u003e\n\n左上のセレクトメニューをクリックし、先ほど作成したプロジェクトを選択します。\n\n\u003cimg src=\"./images/library_selection.png\" /\u003e\n\n\u003cimg src=\"./images/sheet_selection.png\" /\u003e\n\n次は、サブカラムより「ライブラリ」という項目をクリックし、API ライブラリのページに移動します。そのページにて、Google Sheet API という項目を検索して有効化してください。\n\n\u003cimg src=\"./images/auth_info.png\" /\u003e\n\n\u003cimg src=\"./images/get_oauth_client.png\" /\u003e\n\n最後に「認証情報」をクリックして認証情報の設定画面に移動します。そこで新たに OAuth クライアント ID を作成します。 アプリケーションの種類として、「ウェブアプリケーション」を設定して、「認証済みのリダイレクト URI」には「ドメイン名/bid/（現在使用しているブログの BID）/admin/app_google_sheets_callback/」を設定します。\n\n※ablogcms.io で行う場合は、「OAuth 同意画面」のページにある公開ステータスの項目を「テスト」にすることで「認証済みのリダイレクト URI」に正常に登録できます（2021 年 3 月現在）\n\n\u003cimg src=\"./images/download_json.png\" /\u003e\n\nその後、クライアント ID などの情報が記述された JSON ファイルをダウンロードしましょう。その後、ダウンロードした JSON ファイルをサーバーにアップロードします。ドキュメントルート以下にアップロードをするとブラウザからアクセスできてしまいますので、ドキュメントルートより上の階層にアップロードするのが望ましいです。\n\n## 2. ClientID JSON を CMS 側に登録\n\n\u003cimg src=\"./images/install_app.png\" /\u003e\n\n次は CMS 側の設定です。まずは、拡張アプリから Hook 処理をかけるように config.server.php を 1 にします。\n\n```php\ndefine('HOOK_ENABLE', 1);\n```\n\n管理画面 \u003e 拡張アプリより、 Google Sheets をインストールします。インストール完了後は、管理画面 \u003e Google Sheets より Google Sheets の管理画面に移動します。\n\n\u003cimg src=\"./images/app_screen.png\" /\u003e\nそして先ほど設置したJSONファイルへのパスを記述します。絶対パスで記述しましょう。パスを記述後、設定を保存してから、「認証」ボタンをクリックして認証するようにしましょう。\n\n※認証はフォームの送信先となるブログで行ってください。\n\n## 3. フォーム ID に書き込みしたい SpreadsheetID と SheetID を紐づける\n\n管理画面 \u003e フォームより、Google スプレッドシートと紐付けたいフォーム ID の変更画面に移動すると、「Google スプレッドシート Form 設定」という項目が増えています。\nGoogleスプレッドシート連携を有効にし、フォーム ID に対して書き込みしたい Google Sheets の ID を指定してください。\n\n\u003cimg src=\"./images/set_sheetid.png\" /\u003e\n\nSpreadsheetID と SheetID は、開いている スプレッドシートの URL から調べることができます。\n\nhttps://docs.google.com/spreadsheets/d/{SpreadsheetID}/edit#gid={SheetID}\n\n設定が完了すれば、お問い合わせフォームから送信された内容を Google Sheets に自動で追加登録できます。下の図のような実行結果になっていれば成功です。\n\n\u003cimg src=\"./images/spreadsheet.png\" /\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappleple%2Facms-google-sheets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappleple%2Facms-google-sheets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappleple%2Facms-google-sheets/lists"}