ノンプロ研初心者向け講座【GAS+freee APIコース】第８回 freee APIとリクエストの基礎

Hey!Hanaちゃん @HeyHanachan

まずはGETリクエストで事業所情報を取得 #ノンプロ研　#GAS_freeeAPI講座

✨まあちゃん✨ @maari_888

Bearerの後の半角スペースは何を意味するんだろう？ #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

freeeでログインできる事業所名が全てログに出てきます！ #ノンプロ研　#GAS_freeeAPI講座

Smart経理×GAS @Smartkeiri_GAS

※Bearerの後に半角スペース。半角スペースないとエラーになる #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

Bearer の後の半角スペースは落とし穴ですね😇 #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

事業所情報に含まれる事業者番号は、freeeAPIで他のデータを操作する際に都度必要になります #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

リクエストURLとは？ ここにアクセスするとデータ種別がとれますよ～といったもの #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

リクエストURLのパラメーターと、オプションパラメーターは言葉は似ていますが指している内容は異なります。ややこしいね🥺 #ノンプロ研　#GAS_freeeAPI講座

Smart経理×GAS @Smartkeiri_GAS

リクエストURLの作成（①＋②＋③） ①共通エンドポイント ②個別URL ③パラメーター（URLを構成する？以降の部分をパラメーターという） #ノンプロ研　#GAS_freeeAPI講座

りーさん @rii_gas

URLのパラメーターとオプションパラメーターは違う！ #ノンプロ研　#GAS_freeeAPI講座

Smart経理×GAS @Smartkeiri_GAS

freeeのリファレンスは穴が開くほど読む！ #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

リクエストURLの3つの要素 ①共通エンドポイント ②個別URL ③パラメーター #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

（事業所一覧の取得の場合） ①共通エンドポイント api.freee.co.jp ②個別URL /api/1/companies （特定の事業所のみ） /api/1/companies/{id} ③パラメーター なし #ノンプロ研　#GAS_freeeAPI講座

Smart経理×GAS @Smartkeiri_GAS

共通エンドポイント、個別URL、パラメーターはリファレンスに記載している。 パラメーターはない時もある。 #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

他のデータ取得の際は、会計リファレンスを読みに行きましょう！ freeeAPIはリファレンスを何度も何度も読んで理解することが重要になってきます！！ #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

GETリクエストのパラメーター（最低限必要なものは二つ） headers：'Authorization': 'Bearer ' + アクセストークン method：'get'（データ取得の場合） #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

アクセストークンとは？ （6時間だけ有効な）期間限定の鍵のようなもの🗝️ #ノンプロ研　#GAS_freeeAPI講座

Smart経理×GAS @Smartkeiri_GAS

オプションパラメーターの作成 引数のparams GETリクエストでは、headersとmethodだけでOK headers 'Authorization': 'Bearer ' + アクセストークン method get #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

認証関数で許可証（アクセストークン）をもらい、許可証を持ってデータの参照・操作する #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

リクエストの送信：UrlFetchApp.fetch(url, params) url（第一引数）：リクエストURL params（第二引数）：オプションパラメーター #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

戻り値（レスポンス）には取得したいデータやエラーの内容が返ってきます #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

API使用制限 一定期間（短い時間）に過度のアクセスをすると（for文でのループ処理等）、APIアクセスが制限される場合があります #ノンプロ研　#GAS_freeeAPI講座

りーさん @rii_gas

GETのリクエストコードは何度も書いて体に覚えさせるべし✨ #ノンプロ研　#GAS_freeeAPI講座

Hey!Hanaちゃん @HeyHanachan

プランによって異なります #ノンプロ研　#GAS_freeeAPI講座 pic.twitter.com/YgpZPLoHC4

拡大

Hey!Hanaちゃん @HeyHanachan

ループ処理などで連続アクセスする場合は、待機（スリープ）処理を入れるようにしましょう。 Utilities.sleep(1000); ※1秒スリープ #ノンプロ研　#GAS_freeeAPI講座