Purchase Shipping Labels with ShipEngine
Made by ShipEngine
指定された Cloud Firestore コレクションに書き込まれたドキュメントのコンテンツに基づいて、配送ラベルを購入します。
この拡張機能の動作
この拡張機能を使用すると、ShipEngine を使用して米国国内配送または国際配送の配送ラベルを作成できます。60 社を超える配送業者をすばやく一元管理して、グローバル リーチを拡大してください。配送業者の完全なリストはこちらをご覧ください。
この拡張機能が呼び出される基本的なドキュメント書き込みの例は次のとおりです。
admin .firestore() .collection('shipments') .add({ shipment: { carrierId: 'se-423887', serviceCode: 'usps_media_mail', shipDate: '2021-09-21', validateAddress: 'no_validation', shipTo: { name: 'Amanda Miller', addressLine1: '525 S Winchester Blvd', cityLocality: 'San Jose', stateProvince: 'CA', postalCode: '95128', countryCode: 'US', }, shipFrom: { name: 'John Doe', phone: '111-111-1111', addressLine1: '4009 Marathon Blvd', addressLine2: 'Suite 300', cityLocality: 'Austin', stateProvince: 'TX', postalCode: '78756', countryCode: 'US', }, packages: [ { weight: { value: 1.0, unit: 'ounce', }, }, ], }, });
追加の設定
この拡張機能をインストールする前に、Firebase プロジェクトで Cloud Firestore データベースを設定していることを確認してください。
また、[ShipEngine アカウント|https://www.shipengine.com/signup/?ref=firebase]を作成するか、既存のアカウントを使用する場合は、この拡張機能を設定するときに ShipEngine API Management ページから ShipEngine API Key を提供する必要があります。
料金
拡張機能をインストールするには、プロジェクトを Blaze（従量課金制）プランに含める必要があります。
- この拡張機能に必要な Firebase リソースに対しては、使用しない場合でも、小額（通常は約 $0.01/月）が請求されます。
- この拡張機能は、次のような他の Firebase サービスや Google Cloud Platform サービスを使用するため、こうしたサービスの無料枠を超えた場合には関連する料金が発生します。
- Cloud Firestore
- Cloud Functions（Node.js 15 を超えるランタイム。FAQ を参照)
- Cloud Secret Manager
この拡張機能を使用するには、ShipEngine アカウントも必要です。ShipEngine アカウントの利用に関連する費用については、すべてお客様の負担となります。
この拡張機能をインストールする方法
Firebase CLI の使用
拡張機能のインストールと管理は、Firebase CLI でも行えます。
ステップ 1: 以下の npm コマンドを実行して、CLI をインストールするか、最新バージョンの CLI に更新します。
npm install -g firebase-tools正常に機能しない場合は、Firebase CLI リファレンスを確認するか、npm のアクセス権を変更してください。
ステップ 2: 新しい Firebase プロジェクトのディレクトリを設定するか、既存のプロジェクト ディレクトリに移動します
ステップ 3: 次を実行して、この拡張機能を拡張機能のマニフェストに追加します
firebase ext:install shipengine/purchase-labels --local --project=projectId_or_alias
ステップ 4（任意）: Firebase Emulator Suite を使用して、この拡張機能をローカルでテストします
firebase emulators:start
ステップ 5: マニフェストにある拡張機能をプロジェクトにデプロイします
firebase deploy --only extensions --project=projectId_or_alias