GSP421

概要

Google API Explorer は、さまざまな Google API をインタラクティブに試すことができるツールです。API Explorer を使用すると、次のことができます。

• 利用可能な API とバージョンをすばやくブラウジングする。
• 各 API で利用可能なメソッドを表示して、サポートされているパラメータやインライン ドキュメントを確認する。
• 任意のメソッドに対してリクエストを実行し、リアルタイムでレスポンスを確認する。
• 認証および承認済みの API 呼び出しを行う。
• すべてのサービス、メソッド、最近のリクエストの中から目的のものをすばやく検索する。

Cloud Storage では、世界中のどこからでも、いつでもデータを保存、取得できます。データの量に制限はありません。ウェブサイト コンテンツの提供、アーカイブと障害復旧のためのデータの保存、直接ダウンロードによるユーザーへの大きなデータ オブジェクトの配布など、さまざまなシナリオで Cloud Storage を使用できます。

このラボでは、API Explorer を使用して Cloud Storage API のリクエストを実行します。Cloud Storage バケットを作成および削除する方法と、Cloud Storage のファイルをコピーおよび削除する方法を学べます。

目標

このラボでは、次の作業を行います。

• API Explorer を使用して Cloud Storage バケットを作成する。
• 作成した Cloud Storage バケットに画像ファイルをアップロードする。
• API Explorer を使用して、画像ファイルを別の Cloud Storage バケットにコピーする。
• API Explorer を使用して、画像ファイルを Cloud Storage バケットから削除する。
• API Explorer を使用して Cloud Storage バケットを削除する。

設定と要件

[ラボを開始] ボタンをクリックする前に

こちらの手順をお読みください。ラボの時間は記録されており、一時停止することはできません。[ラボを開始] をクリックするとスタートするタイマーは、Google Cloud のリソースを利用できる時間を示しています。

このハンズオンラボでは、シミュレーションやデモ環境ではなく、実際のクラウド環境を使ってご自身でラボのアクティビティを行うことができます。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

• 標準的なインターネット ブラウザ（Chrome を推奨）

注: このラボの実行には、シークレット モードまたはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生することを防ぎます。

• ラボを完了するために十分な時間を確保してください。ラボをいったん開始すると一時停止することはできません。

注: すでに個人の Google Cloud アカウントやプロジェクトをお持ちの場合でも、このラボでは使用しないでください。アカウントへの追加料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるポップアップでお支払い方法を選択してください。 左側の [ラボの詳細] パネルには、以下が表示されます。

   • [Google Cloud コンソールを開く] ボタン
   • 残り時間
   • このラボで使用する必要がある一時的な認証情報
   • このラボを行うために必要なその他の情報（ある場合）

2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウでリンクを開く] を選択します）。

   ラボでリソースが起動し、別のタブで [ログイン] ページが表示されます。

   ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

   注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

   {{{user_0.username | "Username"}}}

   [ラボの詳細] パネルでも [ユーザー名] を確認できます。

4. [次へ] をクリックします。

5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

   {{{user_0.password | "Password"}}}

   [ラボの詳細] パネルでも [パスワード] を確認できます。

6. [次へ] をクリックします。

   重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

7. その後次のように進みます。

   • 利用規約に同意してください。
   • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
   • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスのリストを含むメニューを表示するには、左上のナビゲーション メニューをクリックします。

タスク 1. Cloud Storage バケットを作成する

1. Cloud Storage API Explorer ツールにアクセスするには、ナビゲーション メニューで [API とサービス] > [ライブラリ] を選択します。

2. 検索バーに「Cloud Storage」と入力します。

3. 検索結果のリストで Google Cloud Storage JSON API をクリックし、

4. API が有効になっていることを確認します。有効になっていない場合は、[有効にする] をクリックします。

5. Buckets: insert リファレンスを開きます。新しいタブが開いて API Explorer のページが読み込まれます。

[APIs Explorer] ページが表示されます。

注: 次のセクションでは、Cloud Storage JSON API から insert メソッドを使用します。API リファレンスですべての API バージョンとそのメソッドを確認できます。

6. [この API を試す] にある右側のパネルからリクエスト本文をクリックし、Storage バケットの詳細を入力します。

• project: プロジェクト ID - を追加します。
• Request body: Key-Value ペア name の隣にある引用符の中をクリックして、Cloud Storage バケットの一意の名前を入力します。Cloud Storage バケットの命名ガイドラインに沿った名前を付けてください。

メソッドが次のようになります。

注: プロジェクト ID の末尾にスペースが含まれていないことを確認してください。[Credentials] の [Google OAuth 2.0] と [API key] がオンになっていることを確認します。

注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。

7. [Execute] ボタンをクリックします。

8. このラボを開始するときに使用した受講者アカウントを選択します。

9. 次の画面で [許可] をクリックすると、API Explorer にアクセスできます。

次のようなレスポンスが返されます。

{ "kind": "storage#bucket", "id": "qwiklabs-bucket01", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket01", "projectNumber": "250399850182", "name": "qwiklabs-bucket01", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

[進行状況を確認] をクリックして、目標に沿って進んでいることを確認します。 Cloud Storage バケットを作成する。

タスク 2. 2 つ目の Cloud Storage バケットを作成する

バケット間でファイルをコピーできるように、Cloud Storage バケットをもう 1 つ作成します。

1. insert メソッドを表示したまま、[project] フィールドにプロジェクト ID が引き続き表示されていることを確認します。

2. [Request body] の Key-Value ペア name に 2 つ目のバケットの一意の名前を入力します。

3. 各フィールドに余分なスペースが含まれていないことを確認し、

4. [Execute] ボタンをクリックします。次のようなレスポンスが返されます。

{ "kind": "storage#bucket", "id": "qwiklabs-bucket02", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02", "projectNumber": "250399850182", "name": "qwiklabs-bucket02", "timeCreated": "2019-10-18T13:59:08.300Z", "updated": "2019-10-18T13:59:08.300Z", "metageneration": "1", "iamConfiguration": { "bucketPolicyOnly": { "enabled": false }, "uniformBucketLevelAccess": { "enabled": false } }, "location": "US", "locationType": "multi-region", "storageClass": "STANDARD", "etag": "CAE=" }

これで、insert メソッドを使用して 2 つのバケットを作成できました。次に、Cloud コンソールでバケットを確認します。

[進行状況を確認] をクリックして、目標に沿って進んでいることを確認します。 2 つ目の Cloud Storage バケットを作成する。

Cloud コンソール で Cloud Storage バケットを確認する

1. Cloud コンソールに戻り、ナビゲーション メニューから [Cloud Storage] に移動して、Cloud Storage バケットが作成されたことを確認します。

2. ナビゲーション メニューから、[Cloud Storage] > [バケット] を選択します。先ほど作成したバケットが追加されているはずです。

次のステップでも Cloud コンソールから作業を行います。API Explorer のタブも閉じないでください。

タスク 3. Cloud Storage バケットにファイルをアップロードする

API Explorer のメソッドを試すために、Cloud Storage バケットにファイルをアップロードします。

1. 次の画像をパソコンに保存して、demo-image1.png という名前を付けます。

2. 次に、このエイダ ラブレスのパブリック ドメイン画像をパソコンに保存して、demo-image2.png という名前を付けます。

3. Cloud Storage ブラウザのリストで、1 つ目のバケットを選択します。

4. [ファイルをアップロード] をクリックし、パソコン上の demo-image1.png と demo-image2.png を選択します。

両方の画像ファイルがバケットに追加されて、次のようになります。

[進行状況を確認] をクリックして、目標に沿って進んでいることを確認します。 Cloud Storage バケットにファイルをアップロードする（demo-image1.png と demo-image2.png）

次に、画像ファイルの 1 つを 2 つ目の Cloud Storage バケットにコピーします。

タスク 4. Cloud Storage バケット間でファイルをコピーする

1. 左側の [API とリファレンス] セクションで、[JSON API] > [API リファレンス] > [Objects] > [copy] に移動して、copy メソッドを使用します。または、API Explorer を使用して Storage バケット間でファイルをコピーするには、Objects: copy リファレンスを使用します。

2. 次のように更新します。

• sourceBucket: デモ画像ファイルを含むバケットの名前を入力します。
• sourceObject: 「demo-image1.png」と入力します。
• destinationBucket: 2 つ目の（空の）バケットの名前を入力します。
• destinationObject: 「demo-image1-copy.png」と入力します。

メソッドが次のようになります。

3. [Credentials] の [Google OAuth 2.0] と [API key] がオンになっていることを確認します。

注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。

4. 各フィールドに余分なスペースが含まれていないことを確認し、

5. 下にスクロールして [Execute] をクリックします。

次のような出力が返されます。

{ "kind": "storage#object", "id": "qwiklabs-bucket02/demo-image1-copy.png/1571408245199237", "selfLink": "https://www.googleapis.com/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png", "name": "demo-image1-copy.png", "bucket": "qwiklabs-bucket02", "generation": "1571408245199237", "metageneration": "1", "contentType": "image/png", "timeCreated": "2019-10-18T14:17:25.198Z", "updated": "2019-10-18T14:17:25.198Z", "storageClass": "STANDARD", "timeStorageClassUpdated": "2019-10-18T14:17:25.198Z", "size": "401951", "md5Hash": "LbpHpwhnApQKQx9IEXjTsQ==", "mediaLink": "https://www.googleapis.com/download/storage/v1/b/qwiklabs-bucket02/o/demo-image1-copy.png?generation=1571408245199237&alt=media", "owner": { "entity": "user-gcpstaging93416_student@qwiklabs.net" }, "crc32c": "j5oPrg==", "etag": "CIWjgvL/peUCEAE=" }

これで、objects.copy メソッドを使用してバケット間でファイルをコピーできました。

[進行状況を確認] をクリックして、目標に沿って進んでいることを確認します。 Cloud Storage バケット間でファイルをコピーする（demo-image1-copy.png）

更新されたバケットを Cloud コンソールで確認する

1. このステップは Cloud コンソールに戻って行います。Cloud Storage バケットの詳細ページが表示されているはずです。

2. 左側のメニューで [バケット] をクリックし、2 つ目のバケットを選択します。demo-image1.png のコピーが追加されているはずです。

タスク 5. Cloud Storage バケットからファイルを削除する

1. 左側の [API とリファレンス] セクションで、[JSON API] > [API リファレンス] > [Objects] > [delete] に移動します。または、API Explorer を使用して Cloud Storage バケットからファイルを削除するには、Objects: delete リファレンスを使用します。

2. Cloud Storage バケットから画像ファイルを削除します。

• bucket: 両方のデモ画像ファイルを含むバケットの名前を入力します。
• object: 「demo-image1.png」と入力します。メソッドが次のようになります。

3. [Credentials] の [Google OAuth 2.0] と [API key] がオンになっていることを確認します。

注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。

4. 各フィールドに余分なスペースが含まれていないことを確認し、

5. 下にスクロールして [Execute] をクリックします。

次のような出力が返されます。

6. 次に、Cloud Storage バケットから 2 つ目の画像を削除します。引き続き同じメソッドで、[object] に「demo-image2.png」と入力します。バケット名は同じままです。メソッドが次のようになります。

7. 下にスクロールして [Execute] をクリックします。次のような出力が返されます。

これで、objects.delete メソッドを使用してバケットからファイルを削除できました。次に、ファイルが削除されたことを Cloud コンソールで確認します。

更新されたバケットを Cloud コンソールで確認する

1. このステップは Cloud コンソールに戻って行います。Cloud Storage バケットの詳細ページが表示されているはずです。

2. 左側のメニューで [バケット] をクリックし、1 つ目のバケットを選択します。両方の画像が削除されているはずです。

タスク 6. Cloud Storage バケットの削除

1. 左側の [API とリファレンス] セクションで [JSON API] > [API リファレンス] > [バケット] > delete に移動して buckets.delete メソッドを使用します。または、API Explorer を使用して Cloud Storage バケットを削除するには、Buckets: delete リファレンスを使用します。

1 つ目の（空の）Cloud Storage バケットを削除します。

2. [bucket] に、1 つ目のバケットの名前を入力します。メソッドが次のようになります。

3. [Credentials] の [Google OAuth 2.0] と [API key] がオンになっていることを確認します。

注: 認証情報に関するよくある質問を表示するには、[Credentials] の横にある疑問符アイコンをクリックします。

4. 各フィールドに余分なスペースが含まれていないことを確認し、

5. 下にスクロールして [Execute] をクリックします。次のような出力が返されます。

これで、buckets.delete メソッドを使用してバケットを削除できました。

更新されたバケットを Cloud コンソールで確認する

1. このステップは Cloud コンソールに戻って行います。詳細ページが表示されているはずです。

2. 左側のメニューで [バケット] をクリックします。1 つ目のバケットが削除されているはずです。

以上でこのラボのすべてのステップが完了しました。ここでラボを終了することもできますが、時間が残っている場合は新しいメソッドをいくつか試してみましょう。

タスク 7. 理解度チェック

今回のラボで学習した内容の理解を深めていただくため、以下の選択式問題を用意しました。正解を目指して頑張ってください。

お疲れさまでした

このラボでは、API Explorer を使用して Cloud Storage バケットを作成しました。API Explorer の特定のメソッドを使用して画像ファイルのコピーと削除も行いました。画像ファイルを削除した後、delete メソッドを使用してバケット全体を削除する方法も学びました。これで、Cloud Storage の概要と、このサービスのメソッドを API Explorer からプロビジョニングする方法をしっかりと理解できたことと思います。

クエストを完了する

このセルフペース ラボは、「Exploring APIs」クエストの一部です。クエストとは学習プログラムを構成する一連のラボのことで、完了すると成果が認められてバッジが贈られます。バッジは公開して、オンライン レジュメやソーシャル メディア アカウントにリンクできます。このラボの修了後、こちらのクエストに登録すれば、すぐにクレジットを受け取ることができます。受講可能な全クエストについては、Google Cloud Skills Boost カタログをご覧ください。

次のステップと詳細情報

API Explorer の他の演習については、次のラボをお試しください。

API Explorer: クラスタを作成して更新する

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2023 年 5 月 1 日

ラボの最終テスト日: 2023 年 2 月 8 日

Copyright 2024 Google LLC All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。