CLI を使い始める

products

@orchestor-inc/cli のコマンドリファレンスです。

コマンド一覧

  • orc products create — Create products
  • orc products list — List products
  • orc products get — Get product
  • orc products update — Update products
  • orc products delete — Delete products
  • orc products attribute-keys list — List product attribute keys
  • orc products summary get — Get product summary
  • orc products competitors list — List product competitors
  • orc products fanouts list — List product fanouts
  • orc products attributes list — List product attributes
  • orc products prompts list — List product prompts

orc products create

承認済みの商品を 1〜1,000 件登録し、created と rejected の各項目を返します。一部の項目が拒否されても、成功した項目と拒否理由を同じ JSON 出力で確認できます。

構文

printf '%s' '{"products":[{"external_id":"YOUR_EXTERNAL_ID","brand_id":"YOUR_BRAND_ID","name":"YOUR_PRODUCT_NAME","attributes":{"category":"YOUR_CATEGORY"}}]}' \
  | orc products create --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_REQUEST_KEY --json

フラグ

フラグ型必須説明
--productsstringはい商品オブジェクトの JSON 配列。完全な本文には --stdin を使用します。
--idempotency-keystringいいえ再試行時に同じ結果を返すための一意なキー。

出力とリクエストの共通オプションはグローバルオプションを参照してください。

orc products list

List products

構文

orc products list [flags]

フラグ

フラグ型必須説明
--brand-idstringいいえvalue
--limitnumberいいえMaximum number of items to return
--cursorstringいいえOpaque cursor for the next page

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product list

ヘルプ

orc products list --help

orc products get

選択したワークスペースの商品を ID で取得します。別のワークスペースの商品 ID は not found として拒否されます。

構文

orc products get YOUR_PRODUCT_ID --workspace YOUR_WORKSPACE_ID --json

引数

引数必須説明
idはい商品 ID

出力とリクエストの共通オプションはグローバルオプションを参照してください。

orc products update

1〜1,000 件の商品を一括更新します。出力の updated、skipped、rejected を個別に確認してください。

構文

printf '%s' '{"products":[{"id":"YOUR_PRODUCT_ID","name":"YOUR_UPDATED_PRODUCT_NAME"}]}' \
  | orc products update --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_REQUEST_KEY --json

フラグ

フラグ型必須説明
--productsstringはいID と変更項目を持つ商品オブジェクトの JSON 配列。完全な本文には --stdin を使用します。
--idempotency-keystringいいえ再試行時に同じ結果を返すための一意なキー。

出力とリクエストの共通オプションはグローバルオプションを参照してください。

orc products delete

1〜1,000 件の商品を論理削除し、deleted と skipped を返します。対話端末では確認を求め、非対話実行では API を呼ぶ前に --yes を要求します。

構文

printf '%s' '{"ids":["YOUR_PRODUCT_ID"]}' \
  | orc products delete --workspace YOUR_WORKSPACE_ID --stdin --idempotency-key YOUR_REQUEST_KEY --yes --json

フラグ

フラグ型必須説明
--idsstringはいカンマ区切りの商品 ID。JSON 本文には --stdin を使用します。
--idempotency-keystringいいえ再試行時に同じ結果を返すための一意なキー。
--yesbooleanいいえ非対話実行で削除確認を省略。

--dry-run はリクエスト本文と対象ワークスペースを表示しますが、API を呼びません。

orc products attribute-keys list

選択したワークスペースの商品で使われているカスタム属性キーを一覧します。

構文

orc products attribute-keys list --workspace YOUR_WORKSPACE_ID --json

出力とリクエストの共通オプションはグローバルオプションを参照してください。

orc products summary get

Get product summary

構文

orc products summary get [flags]

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product summary

ヘルプ

orc products summary get --help

orc products competitors list

List product competitors

構文

orc products competitors list <id> [flags]

引数

引数必須説明
idはいPath parameter: id

フラグ

フラグ型必須説明
--limitnumberいいえMaximum number of items to return
--cursorstringいいえOpaque cursor for the next page

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product competitors

ヘルプ

orc products competitors list --help

orc products fanouts list

List product fanouts

構文

orc products fanouts list <id> [flags]

引数

引数必須説明
idはいPath parameter: id

フラグ

フラグ型必須説明
--limitnumberいいえMaximum number of items to return
--cursorstringいいえOpaque cursor for the next page

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product fanouts

ヘルプ

orc products fanouts list --help

orc products attributes list

List product attributes

構文

orc products attributes list <id> [flags]

引数

引数必須説明
idはいPath parameter: id

フラグ

フラグ型必須説明
--limitnumberいいえMaximum number of items to return
--cursorstringいいえOpaque cursor for the next page

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product attributes

ヘルプ

orc products attributes list --help

orc products prompts list

List product prompts

構文

orc products prompts list <id> [flags]

引数

引数必須説明
idはいPath parameter: id

フラグ

フラグ型必須説明
--limitnumberいいえMaximum number of items to return
--cursorstringいいえOpaque cursor for the next page

出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。

互換エイリアス

  • orc product prompts

ヘルプ

orc products prompts list --help