みんカラブログはなんでも好きなことを書いて良いと認識しているので好きなことを書きます。
備忘録のようなものです。
タイトルからして、見返してみたらエンジニア語しか書いていませんね^^;
・ネクストエンジン
ネクストエンジンと言うのは複数モールに展開している受注情報を一元化できるOrder Manegement System(OMS)のことで・・・
・Googleスプレッドシート
Googleスプレッドシートと言うのはMicrosoft社のExcelが有るものの、Googleが提唱する超並列処理を実現するための・・・
・API接続
API接続と言うのはApplication Programming Interfaceの略で、アプリケーション同士を接続するための国際規格に則った接続方式で・・・
・GASの開発
Google Apps Scriptの略でJavaScriptを元にしたGoogle独自のスクリプト言語で・・・
そもそもネクストエンジンとGoogleスプレッドシートを繋げたいん？
我が社は情報を以前はExcelで店長がUSBメモリーで各店舗に回ってデータを抜いていたのが20世紀でない状況を見て、クラウドにしようと思い・・・
と説明しだすとそれぞれで1つ以上の記事が書ける内容です^^;
なので、みん友の方に最後まで見ていただけると思っていません。
ブログなので好き勝手書いて良いですからね(笑)
この3週間の間、狂気と思われる時間を過ごしてきたエンジニアのブログなので、エンジニア語満載です。
最後まで読み進められた貴方はエンジニアですよ。
プロのエンジニアの御方！
是非、無知の私にコメントなりメッセージで優しいアドバイスをお願いいたしますm(_ _)m
私は私自身の社会的な立ち位置がわかっておりません^^;
ネクストエンジンとGoogleスプレッドシートをAPI接続できるGASの開発：認証編
というブログで愚痴のような事を書いてしまいました^^;
なので、お時間の有る方は御覧くださいm(_ _)m
と言うものの、ネクストエンジンとGoogleスプレッドシートをAPI接続するGAS：在庫情報取得編のスクリプトを全文でご覧いただけます。
また、
Claudeを使い、ネクストエンジンとGoogleスプレッドシートをAPI接続する：認証編でも、認証編コードの全文とステップごとの導入手順を紹介しています。
認証ができれば、次は在庫情報の取得を行ってまいります。
何度かClaudeとやり取りをして成功したと思われるスクリプト全文です。
やり取りしたプロンプトエンジニアリングは・・・長すぎるので割愛(笑)
若し、私が今回行ったプロンプトエンジニアリングの全文を知りたいという要望がありましたら、是非コメントくださいm(_ _)m
みんカラではマニアックすぎるのでQiitaで公開しようと思います。
是非コメントをお願いしますm(_ _)m
大事なことなので2度言いました(笑)
在庫情報取得.gs
--------------------------------------------------
/**
* ネクストエンジン在庫情報取得スクリプト（完全版）
*
* 【目的】
* スプレッドシートの商品コードに対応する詳細在庫情報をネクストエンジンAPIから取得し更新
*
* 【機能】
* 1. スプレッドシートから商品コードを読み取り
* 2. ネクストエンジン商品マスタAPIで基本情報を取得
* 3. ネクストエンジン在庫マスタAPIで詳細在庫情報を取得
* 4. スプレッドシートの在庫情報を詳細データで更新
*
* 【事前設定】
* スクリプトプロパティに以下の値を設定してください：
* - SPREADSHEET_ID: 対象スプレッドシートのID
* - SHEET_NAME: 対象シート名
*
* 【注意事項】
* - 認証スクリプトで事前にトークンを取得済みである必要があります
* - API制限を考慮して適切な間隔でリクエストを送信します
* - 大量データの場合は時間がかかる可能性があります
*/
// ネクストエンジンAPIのエンドポイントは認証.gsで定義済み
// 列のマッピング（0ベース）
const COLUMNS = {
GOODS_CODE: 0, // A列: 商品コード
GOODS_NAME: 1, // B列: 商品名
STOCK_QTY: 2, // C列: 在庫数
ALLOCATED_QTY: 3, // D列: 引当数
FREE_QTY: 4, // E列: フリー在庫数
RESERVE_QTY: 5, // F列: 予約在庫数
RESERVE_ALLOCATED_QTY: 6, // G列: 予約引当数
RESERVE_FREE_QTY: 7, // H列: 予約フリー在庫数
DEFECTIVE_QTY: 8, // I列: 不良在庫数
ORDER_REMAINING_QTY: 9, // J列: 発注残数
SHORTAGE_QTY: 10, // K列: 欠品数
JAN_CODE: 11 // L列: JANコード
};
/**
* スプレッドシート設定を取得
*/
function getSpreadsheetConfig() {
const properties = PropertiesService.getScriptProperties();
const spreadsheetId = properties.getProperty('SPREADSHEET_ID');
const sheetName = properties.getProperty('SHEET_NAME');
if (!spreadsheetId || !sheetName) {
throw new Error('スプレッドシート設定が不完全です。スクリプトプロパティにSPREADSHEET_IDとSHEET_NAMEを設定してください。');
}
return {
spreadsheetId,
sheetName
};
}
/**
* メイン関数：在庫情報を更新
*/
function updateInventoryData() {
try {
console.log('=== 在庫情報更新開始 ===');
// スプレッドシート設定を取得
const config = getSpreadsheetConfig();
console.log(`対象スプレッドシート: ${config.spreadsheetId}`);
console.log(`対象シート: ${config.sheetName}`);
// スプレッドシートを取得
const spreadsheet = SpreadsheetApp.openById(config.spreadsheetId);
const sheet = spreadsheet.getSheetByName(config.sheetName);
if (!sheet) {
throw new Error(`シート "${config.sheetName}" が見つかりません`);
}
// データ範囲を取得（ヘッダー行を除く）
const lastRow = sheet.getLastRow();
if (lastRow <= 1) {
console.log('データが存在しません');
return;
}
const dataRange = sheet.getRange(2, 1, lastRow - 1, 12); // 2行目から最終行まで、A列からL列まで
const values = dataRange.getValues();
console.log(`処理対象: ${values.length}行`);
// トークンを取得
const tokens = getStoredTokens();
// 各行の在庫情報を更新
let updateCount = 0;
let errorCount = 0;
for (let i = 0; i < values.length; i++) {
const row = values[i];
const goodsCode = row[COLUMNS.GOODS_CODE];
if (!goodsCode) {
console.log(`${i + 2}行目: 商品コードが空のためスキップ`);
continue;
}
try {
console.log(`${i + 2}行目: ${goodsCode} の在庫情報を取得中...`);
// 在庫情報を取得
const inventoryData = getInventoryByGoodsCode(goodsCode, tokens);
if (inventoryData) {
// スプレッドシートの行を更新
updateRowWithInventoryData(sheet, i + 2, inventoryData);
updateCount++;
console.log(`${i + 2}行目: ${goodsCode} 更新完了`);
} else {
console.log(`${i + 2}行目: ${goodsCode} の在庫情報が見つかりません`);
}
// API制限を考慮して少し待機（1秒）- 2つのAPIを呼び出すため少し長めに設定
Utilities.sleep(1000);
} catch (error) {
console.error(`${i + 2}行目: ${goodsCode} のエラー:`, error.message);
errorCount++;
}
}
console.log('=== 在庫情報更新完了 ===');
console.log(`更新成功: ${updateCount}件`);
console.log(`エラー: ${errorCount}件`);
} catch (error) {
console.error('在庫情報更新エラー:', error.message);
throw error;
}
}
/**
* 保存されたトークンを取得
*/
function getStoredTokens() {
const properties = PropertiesService.getScriptProperties();
const accessToken = properties.getProperty('ACCESS_TOKEN');
const refreshToken = properties.getProperty('REFRESH_TOKEN');
if (!accessToken || !refreshToken) {
throw new Error('アクセストークンが見つかりません。先に認証を完了してください。');
}
return {
accessToken,
refreshToken
};
}
/**
* 商品コードから完全な在庫情報を取得（完全版）
* @param {string} goodsCode - 商品コード
* @param {Object} tokens - アクセストークンとリフレッシュトークン
* @returns {Object|null} 完全な在庫情報
*/
function getInventoryByGoodsCode(goodsCode, tokens) {
try {
console.log('在庫情報取得開始...');
console.log(`対象商品コード: ${goodsCode}`);
// ステップ1: 商品マスタAPIで基本情報を取得
console.log('商品マスタAPI呼び出し中...');
const goodsData = searchGoodsWithStock(goodsCode, tokens);
if (!goodsData) {
console.log('商品が見つかりませんでした');
return null;
}
console.log('商品基本情報取得完了');
console.log(`商品名: ${goodsData.goods_name}`);
console.log(`基本在庫数: ${goodsData.stock_quantity}`);
// ステップ2: 在庫マスタAPIで詳細在庫情報を取得
console.log('在庫マスタAPI呼び出し中...');
const stockDetails = getStockByGoodsId(goodsCode, tokens);
let completeInventoryData;
if (stockDetails) {
console.log('詳細在庫情報取得完了');
// 商品情報と詳細在庫情報を結合
completeInventoryData = {
goods_id: goodsData.goods_id,
goods_name: goodsData.goods_name,
stock_quantity: parseInt(stockDetails.stock_quantity) || parseInt(goodsData.stock_quantity) || 0,
stock_allocated_quantity: parseInt(stockDetails.stock_allocation_quantity) || 0,
stock_free_quantity: parseInt(stockDetails.stock_free_quantity) || 0,
stock_defective_quantity: parseInt(stockDetails.stock_defective_quantity) || 0,
stock_advance_order_quantity: parseInt(stockDetails.stock_advance_order_quantity) || 0,
stock_advance_order_allocation_quantity: parseInt(stockDetails.stock_advance_order_allocation_quantity) || 0,
stock_advance_order_free_quantity: parseInt(stockDetails.stock_advance_order_free_quantity) || 0,
stock_remaining_order_quantity: parseInt(stockDetails.stock_remaining_order_quantity) || 0,
stock_out_quantity: parseInt(stockDetails.stock_out_quantity) || 0
};
console.log('完全な在庫情報を構築しました:');
console.log(`- 在庫数: ${completeInventoryData.stock_quantity}`);
console.log(`- 引当数: ${completeInventoryData.stock_allocated_quantity}`);
console.log(`- フリー在庫数: ${completeInventoryData.stock_free_quantity}`);
console.log(`- 不良在庫数: ${completeInventoryData.stock_defective_quantity}`);
console.log(`- 予約在庫数: ${completeInventoryData.stock_advance_order_quantity}`);
console.log(`- 予約引当数: ${completeInventoryData.stock_advance_order_allocation_quantity}`);
console.log(`- 予約フリー在庫数: ${completeInventoryData.stock_advance_order_free_quantity}`);
console.log(`- 発注残数: ${completeInventoryData.stock_remaining_order_quantity}`);
console.log(`- 欠品数: ${completeInventoryData.stock_out_quantity}`);
} else {
console.log('詳細在庫情報が取得できませんでした。基本情報のみで構築します。');
// 詳細情報が取得できない場合は基本情報のみ使用
completeInventoryData = {
goods_id: goodsData.goods_id,
goods_name: goodsData.goods_name,
stock_quantity: parseInt(goodsData.stock_quantity) || 0,
stock_allocated_quantity: 0,
stock_free_quantity: 0,
stock_defective_quantity: 0,
stock_advance_order_quantity: 0,
stock_advance_order_allocation_quantity: 0,
stock_advance_order_free_quantity: 0,
stock_remaining_order_quantity: 0,
stock_out_quantity: 0
};
}
console.log('在庫情報取得完了');
return completeInventoryData;
} catch (error) {
console.error(`商品コード ${goodsCode} の在庫取得エラー:`, error.message);
console.error('エラー詳細:', error.stack);
return null;
}
}
/**
* 商品コードで商品マスタを検索し在庫情報も取得（修正版）
* @param {string} goodsCode - 商品コード
* @param {Object} tokens - トークン情報
* @returns {Object|null} 商品情報と在庫情報
*/
function searchGoodsWithStock(goodsCode, tokens) {
const url = `${NE_API_URL}/api_v1_master_goods/search`;
const payload = {
'access_token': tokens.accessToken,
'refresh_token': tokens.refreshToken,
'goods_id-eq': goodsCode, // goods_idで検索
'fields': 'goods_id,goods_name,stock_quantity'
};
const options = {
'method': 'POST',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded'
},
'payload': Object.keys(payload).map(key =>
encodeURIComponent(key) + '=' + encodeURIComponent(payload[key])
).join('&')
};
try {
const response = UrlFetchApp.fetch(url, options);
const responseText = response.getContentText();
const responseData = JSON.parse(responseText);
console.log('商品マスタAPI応答:', responseData.result);
// トークンが更新された場合は保存
if (responseData.access_token && responseData.refresh_token) {
updateStoredTokens(responseData.access_token, responseData.refresh_token);
}
if (responseData.result === 'success') {
if (responseData.data && responseData.data.length > 0) {
const goodsData = responseData.data[0];
console.log('取得した商品データ:', goodsData);
return {
goods_id: goodsData.goods_id,
goods_name: goodsData.goods_name,
stock_quantity: goodsData.stock_quantity
};
} else {
console.log(`商品コード ${goodsCode} が見つかりません`);
return null;
}
} else {
console.error(`商品検索エラー:`, JSON.stringify(responseData));
if (responseData.message) {
console.error('エラーメッセージ:', responseData.message);
}
return null;
}
} catch (error) {
console.error('商品マスタAPI呼び出しエラー:', error.toString());
return null;
}
}
/**
* 商品IDから詳細在庫情報を取得（完全版）
* @param {string} goodsId - 商品ID
* @param {Object} tokens - トークン情報
* @returns {Object|null} 詳細在庫情報
*/
function getStockByGoodsId(goodsId, tokens) {
const url = `${NE_API_URL}/api_v1_master_stock/search`;
const payload = {
'access_token': tokens.accessToken,
'refresh_token': tokens.refreshToken,
'stock_goods_id-eq': goodsId, // 正しいフィールド名
'fields': 'stock_goods_id,stock_quantity,stock_allocation_quantity,stock_defective_quantity,stock_remaining_order_quantity,stock_out_quantity,stock_free_quantity,stock_advance_order_quantity,stock_advance_order_allocation_quantity,stock_advance_order_free_quantity'
};
const options = {
'method': 'POST',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded'
},
'payload': Object.keys(payload).map(key =>
encodeURIComponent(key) + '=' + encodeURIComponent(payload[key])
).join('&')
};
try {
const response = UrlFetchApp.fetch(url, options);
const responseText = response.getContentText();
const responseData = JSON.parse(responseText);
console.log('在庫マスタAPI応答:', responseData.result);
// トークンが更新された場合は保存
if (responseData.access_token && responseData.refresh_token) {
updateStoredTokens(responseData.access_token, responseData.refresh_token);
}
if (responseData.result === 'success' && responseData.data && responseData.data.length > 0) {
const stockData = responseData.data[0];
console.log('取得した詳細在庫データ:', stockData);
// 在庫マスタAPIから取得したデータをそのまま返す
return stockData;
} else {
console.log(`商品ID ${goodsId} の在庫情報が見つかりません`);
console.log('API応答詳細:', JSON.stringify(responseData, null, 2));
return null;
}
} catch (error) {
console.error('在庫マスタAPI呼び出しエラー:', error.toString());
return null;
}
}
/**
* スプレッドシートの行を在庫データで更新（完全版）
* @param {Sheet} sheet - シートオブジェクト
* @param {number} rowIndex - 更新する行番号（1ベース）
* @param {Object} inventoryData - 在庫データ
*/
function updateRowWithInventoryData(sheet, rowIndex, inventoryData) {
// 在庫情報の列を更新（C列からK列まで）
const updateValues = [
inventoryData.stock_quantity || 0, // C列: 在庫数
inventoryData.stock_allocated_quantity || 0, // D列: 引当数
inventoryData.stock_free_quantity || 0, // E列: フリー在庫数
inventoryData.stock_advance_order_quantity || 0, // F列: 予約在庫数
inventoryData.stock_advance_order_allocation_quantity || 0, // G列: 予約引当数
inventoryData.stock_advance_order_free_quantity || 0, // H列: 予約フリー在庫数
inventoryData.stock_defective_quantity || 0, // I列: 不良在庫数
inventoryData.stock_remaining_order_quantity || 0, // J列: 発注残数
inventoryData.stock_out_quantity || 0 // K列: 欠品数
];
// C列からK列まで更新
const range = sheet.getRange(rowIndex, COLUMNS.STOCK_QTY + 1, 1, updateValues.length);
range.setValues([updateValues]);
console.log('更新データ:', updateValues);
console.log('在庫管理スクリプト: データ取得の不具合で最新版を実行したログとなります。');
console.log('');
console.log(`取得した在庫データ: { goods_id: '${inventoryData.goods_id}', goods_name: '${inventoryData.goods_name}', stock_quantity: ${inventoryData.stock_quantity}, stock_allocated_quantity: ${inventoryData.stock_allocated_quantity}, stock_free_quantity: ${inventoryData.stock_free_quantity}, stock_defective_quantity: ${inventoryData.stock_defective_quantity}, stock_advance_order_quantity: ${inventoryData.stock_advance_order_quantity}, stock_advance_order_allocation_quantity: ${inventoryData.stock_advance_order_allocation_quantity}, stock_advance_order_free_quantity: ${inventoryData.stock_advance_order_free_quantity}, stock_remaining_order_quantity: ${inventoryData.stock_remaining_order_quantity}, stock_out_quantity: ${inventoryData.stock_out_quantity} }`);
}
/**
* トークンを更新保存
* @param {string} accessToken - 新しいアクセストークン
* @param {string} refreshToken - 新しいリフレッシュトークン
*/
function updateStoredTokens(accessToken, refreshToken) {
const properties = PropertiesService.getScriptProperties();
properties.setProperties({
'ACCESS_TOKEN': accessToken,
'REFRESH_TOKEN': refreshToken,
'TOKEN_UPDATED_AT': new Date().getTime().toString()
});
console.log('トークンを更新しました');
}
/**
* 特定の商品コードのみ更新（テスト用・完全版）
* @param {string} goodsCode - 更新したい商品コード
*/
function updateSingleProduct(goodsCode) {
try {
console.log('=== バージョン確認: 完全版が実行されています ===');
console.log(`=== 単品更新開始: ${goodsCode} ===`);
// スプレッドシート設定を取得
const config = getSpreadsheetConfig();
const spreadsheet = SpreadsheetApp.openById(config.spreadsheetId);
console.log('スプレッドシート取得成功');
const sheet = spreadsheet.getSheetByName(config.sheetName);
console.log('シート取得結果:', sheet ? 'success' : 'null');
if (!sheet) {
throw new Error(`シート "${config.sheetName}" が見つかりません`);
}
// 商品コードを検索
const dataRange = sheet.getRange(2, 1, sheet.getLastRow() - 1, 12);
console.log('データ範囲取得成功');
const values = dataRange.getValues();
console.log('データ取得成功、行数:', values.length);
let targetRowIndex = -1;
for (let i = 0; i < values.length; i++) {
if (values[i][COLUMNS.GOODS_CODE] === goodsCode) {
targetRowIndex = i + 2; // 実際の行番号（1ベース）
break;
}
}
if (targetRowIndex === -1) {
throw new Error(`商品コード ${goodsCode} がスプレッドシートに見つかりません`);
}
console.log('商品コード発見、行番号:', targetRowIndex);
// トークンを取得
const tokens = getStoredTokens();
console.log('トークン取得成功');
// 在庫情報を取得
console.log('getInventoryByGoodsCode 関数を呼び出します');
const inventoryData = getInventoryByGoodsCode(goodsCode, tokens);
console.log('getInventoryByGoodsCode 完了、結果:', inventoryData ? 'データあり' : 'データなし');
console.log('在庫情報取得結果:', inventoryData ? 'success' : 'null');
if (inventoryData) {
console.log('在庫データ更新開始...');
updateRowWithInventoryData(sheet, targetRowIndex, inventoryData);
console.log(`商品コード ${goodsCode} の更新が完了しました`);
} else {
console.log(`商品コード ${goodsCode} の在庫情報が見つかりませんでした`);
}
} catch (error) {
console.error('単品更新エラー:', error.message);
console.error('エラー発生箇所の詳細:', error.stack);
throw error;
}
}
/**
* 在庫マスタAPIのフィールド確認用テスト関数
*/
function testStockMasterFields(goodsCode = "dcmcoverg-s-S") {
try {
console.log('=== 在庫マスタAPI フィールド確認テスト ===');
console.log(`対象商品コード: ${goodsCode}`);
const tokens = getStoredTokens();
const url = `${NE_API_URL}/api_v1_master_stock/search`;
const payload = {
'access_token': tokens.accessToken,
'refresh_token': tokens.refreshToken,
'stock_goods_id-eq': goodsCode,
'fields': 'stock_goods_id,stock_quantity,stock_allocation_quantity,stock_defective_quantity,stock_remaining_order_quantity,stock_out_quantity,stock_free_quantity,stock_advance_order_quantity,stock_advance_order_allocation_quantity,stock_advance_order_free_quantity'
};
const options = {
'method': 'POST',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded'
},
'payload': Object.keys(payload).map(key =>
encodeURIComponent(key) + '=' + encodeURIComponent(payload[key])
).join('&')
};
const response = UrlFetchApp.fetch(url, options);
const responseText = response.getContentText();
const responseData = JSON.parse(responseText);
console.log('API応答結果:', responseData.result);
if (responseData.result === 'success' && responseData.data && responseData.data.length > 0) {
console.log('取得できたフィールド一覧:');
const stockData = responseData.data[0];
Object.keys(stockData).forEach(key => {
console.log(`- ${key}: ${stockData[key]}`);
});
} else {
console.log('データが取得できませんでした');
console.log('応答詳細:', JSON.stringify(responseData, null, 2));
}
} catch (error) {
console.error('テストエラー:', error.message);
}
}
/**
* 在庫情報の手動リセット（テスト用）
* すべての在庫数値を0にリセット
*/
function resetAllInventoryData() {
try {
console.log('=== 在庫情報リセット開始 ===');
// スプレッドシート設定を取得
const config = getSpreadsheetConfig();
const spreadsheet = SpreadsheetApp.openById(config.spreadsheetId);
const sheet = spreadsheet.getSheetByName(config.sheetName);
const lastRow = sheet.getLastRow();
if (lastRow <= 1) {
console.log('データが存在しません');
return;
}
// C列からK列までを0でクリア
const range = sheet.getRange(2, COLUMNS.STOCK_QTY + 1, lastRow - 1, 9);
const resetValues = Array(lastRow - 1).fill(Array(9).fill(0));
range.setValues(resetValues);
console.log(`${lastRow - 1}行の在庫情報をリセットしました`);
} catch (error) {
console.error('リセットエラー:', error.message);
throw error;
}
}
/**
* スプレッドシートのシート名を確認
*/
function checkSheetNames() {
try {
// スプレッドシート設定を取得
const config = getSpreadsheetConfig();
console.log('使用しているスプレッドシートID:', config.spreadsheetId);
const spreadsheet = SpreadsheetApp.openById(config.spreadsheetId);
const sheets = spreadsheet.getSheets();
console.log('=== スプレッドシート内のシート名一覧 ===');
for (let i = 0; i < sheets.length; i++) {
const sheetName = sheets[i].getName();
console.log(`シート${i + 1}: "${sheetName}" (文字数: ${sheetName.length})`);
}
console.log('');
console.log('現在のSHEET_NAME設定:', `"${config.sheetName}"`);
console.log('上記のシート名のいずれかと完全に一致するようにSHEET_NAMEを設定してください');
} catch (error) {
console.error('シート名確認エラー:', error.message);
console.error('スプレッドシートIDまたは設定が正しいか確認してください');
}
}
/**
* スクリプト設定状況を確認
*/
function checkScriptConfiguration() {
try {
console.log('=== スクリプト設定状況確認 ===');
const properties = PropertiesService.getScriptProperties();
// 必要な設定項目をチェック
const requiredProperties = [
'CLIENT_ID',
'CLIENT_SECRET',
'REDIRECT_URI',
'SPREADSHEET_ID',
'SHEET_NAME',
'ACCESS_TOKEN',
'REFRESH_TOKEN'
];
console.log('【必須設定項目の確認】');
let allConfigured = true;
requiredProperties.forEach(prop => {
const value = properties.getProperty(prop);
const status = value ? '✓ 設定済み' : '✗ 未設定';
console.log(`${prop}: ${status}`);
if (!value) {
allConfigured = false;
}
});
console.log('');
console.log(`【設定完了状況】: ${allConfigured ? '✓ 全て設定済み' : '✗ 未設定項目があります'}`);
if (!allConfigured) {
console.log('');
console.log('【設定方法】');
console.log('GASエディタで以下の手順で設定してください：');
console.log('1. 左メニューの「設定」（歯車アイコン）をクリック');
console.log('2. 「スクリプト プロパティ」セクションで「スクリプト プロパティを追加」をクリック');
console.log('3. 以下のプロパティを追加：');
console.log(' - SPREADSHEET_ID: 対象スプレッドシートのID');
console.log(' - SHEET_NAME: 対象シート名');
console.log(' ※ 認証関連は認証.gsで設定済みの場合はそのまま使用');
}
} catch (error) {
console.error('設定確認エラー:', error.message);
}
}
/**
* スクリプト使用方法ガイド（修正版）
*/
function showUsageGuide() {
console.log('=== 在庫情報取得スクリプト使用方法（修正版） ===');
console.log('');
console.log('【事前設定】');
console.log('スクリプトプロパティに以下を設定してください：');
console.log('- SPREADSHEET_ID: 対象スプレッドシートのID');
console.log('- SHEET_NAME: 対象シート名');
console.log('- その他認証関連設定（認証.gsで設定済みの場合はOK）');
console.log('');
console.log('【設定確認】');
console.log('- checkScriptConfiguration(): 設定状況の確認');
console.log('');
console.log('【前提条件】');
console.log('- 認証スクリプトでトークンが取得済みであること');
console.log('- スプレッドシートに商品コードが入力済みであること');
console.log('');
console.log('【主要関数】');
console.log('1. updateInventoryData()');
console.log(' - 全商品の詳細在庫情報を更新');
console.log(' - 処理時間: 商品数 × 約2.5秒（2つのAPIを呼び出すため）');
console.log('');
console.log('2. updateSingleProduct("商品コード")');
console.log(' - 特定商品の詳細在庫情報のみ更新（テスト用）');
console.log(' - 例: updateSingleProduct("dcmcoverg-s-S")');
console.log('');
console.log('3. testStockMasterFields("商品コード")');
console.log(' - 在庫マスタAPIの動作確認（デバッグ用）');
console.log('');
console.log('4. resetAllInventoryData()');
console.log(' - 全在庫数値を0にリセット（テスト用）');
console.log('');
console.log('【更新される在庫情報】');
console.log('- C列: 在庫数');
console.log('- D列: 引当数');
console.log('- E列: フリー在庫数');
console.log('- F列: 予約在庫数');
console.log('- G列: 予約引当数');
console.log('- H列: 予約フリー在庫数');
console.log('- I列: 不良在庫数');
console.log('- J列: 発注残数');
console.log('- K列: 欠品数');
console.log('');
console.log('【注意事項】');
console.log('- APIレート制限のため各商品間に2秒の待機時間があります');
console.log('- 商品マスタAPIと在庫マスタAPIの2つを順次呼び出すため処理時間が長くなります');
console.log('- 大量の商品がある場合は処理時間が長くなります');
console.log('- エラーが発生した商品はスキップされます');
console.log('');
console.log('【実行推奨順序】');
console.log('1. まず checkScriptConfiguration() で設定確認');
console.log('2. 次に testStockMasterFields("商品コード") でAPIの動作確認');
console.log('3. 次に updateSingleProduct("商品コード") で詳細在庫取得をテスト');
console.log('4. 問題なければ updateInventoryData() で全更新');
}
/**
* テスト実行用関数（設定値を使用）
*/
function testSingleUpdate() {
// デフォルトの商品コードでテスト（実際の商品コードに変更してください）
updateSingleProduct("dcmcoverg-s-S");
}
--------------------------------------------------
こちらのコードですが、
ネクストエンジンとGoogleスプレッドシートをAPI接続できるGASの開発：認証編と同じ、NE_在庫情報取得というプロジェクトの中に認証編とは別のスクリプトで作成しておりますので、ハードコーディングを行うことなく、認証編と同じスクリプトプロパティを使用することが出来ます。
因みに、こちらのコーディングを行う前に行ったプロンプトエンジニアリングの中の文章ですが、
--------------------------------------------------
ヘッダーに
商品コード 商品名 在庫数 引当数 フリー在庫数 予約在庫数 予約引当数 予約フリー在庫数 不良在庫数 発注残数 欠品数 JANコード
が並んでおりまして、商品コード 商品名 JANコードは商品コードを追加するたびにシートを最新の商品コードを含んだものに上書きするのでネクストエンジンからの取得は不要です。
在庫数 引当数 フリー在庫数 予約在庫数 予約引当数 予約フリー在庫数 不良在庫数 発注残数 欠品数
の情報をネクストエンジンからAPI取得したいと思いますので、コード案を出してもらえますか？
--------------------------------------------------
という指示を出しています。
こちらのスクリプトを実行すると・・・
おぉ～取得できるようになりました(^^)
ですが、取得できる件数が少なかったので、
--------------------------------------------------
// API制限を考慮して少し待機（2秒）- 2つのAPIを呼び出すため少し長めに設定
Utilities.sleep(2000);
--------------------------------------------------
を修正して、
--------------------------------------------------
// API制限を考慮して少し待機（0.5秒）- 2つのAPIを呼び出すため少し長めに設定
Utilities.sleep(500);
--------------------------------------------------
に修正しました。
このことで200行程まででしたら在庫情報の取得を行うことが出来ました(^^♪
すげ～な(・・;)
ネクストエンジンとGoogleスプレッドシートをAPI接続できるGoogle Apps Script(GAS)の開発がClaudeで行える時代なのですね(・・;)
しかも、私はGASの開発を殆ど行っていないと言えるほどの、少ない知識レベルしか持ち合わせていません。
というものの、私はエンジニアなのでClaudeに適切なプロンプトエンジニアリングを行った結果なのでしょうね。
こちらの記事はQiitaにて公開予定です。
また、ネクストエンジンでアプリを作る際に、
"特定の企業に公開"では無料の範囲がかなり狭められているのに対して、
"すべての企業に公開"とすることで制限が解除されます。
私の望む月間APIコール数では特定の企業に公開の無料の範囲内では実現不可能でした(-_-;)
"すべての企業に公開"にすることで、ネクストエンジン単体では不足している機能がアプリで実現できることから、ネクストエンジン自体の顧客数獲得に繋げようとしているのでしょうね。
Qiitaの記事は、私が作成したアプリの説明書に転用できます。
そういうのも踏まえたうえで、Qiitaでの公開を選考して行ったわけです。
また、
ネクストエンジンとGoogleスプレッドシートをAPI接続できるGASの開発：認証編ではClaudeの作成したコードをGASのスクリプトに書きに行くだけだったのですが、バージョン管理を行う必要性を感じて、VS Code＆GitHubでパブリックでの作成を行うことにしました。
プライベートではなくパブリックで作成すると言うのは、いわゆるオープンソースでの開発になるのですが、こうすることでGitHubでの制限もかなり解除されます。
一気に新しい単語が出てきましたよね。
私もそう思います^^;
すべての単語がいわゆるエンジニア語です。
その単語に対して理解できないとわからない言葉です。
ですが、エンジニアのやりたいという欲求は止めようがないのです。
ネクストエンジンとGoogleスプレッドシートをAPI接続できるGASの開発：認証編で、やっとスタートに立つことが出来ました。
ですが、それまで使用していたGeminiやGPT-5ではバージョン管理が出来ない故の動作ができなくなるという状況に陥ってしまいました。
失敗事例を経験したわけです。
余談ですが、エンジニアというのは毎日失敗事例を鬼のように経験しています。
何でも出来るというエンジニアと思われがちですが、
新しいことを行う際に失敗なんて無い筈がないので、
毎日一歩すら前に進めない日々を過ごすなんて日常です。
前に進めないというのは毎日膨大な失敗をしているということです。
エンジニアという人種は毎日狂気と思えるほどの失敗経験を得て
今その位置に立っているのです。
その失敗に対して後悔しない、という言い方は適切ではないと思いますが、
失敗した事例を元に別のやり方を行って成功に導くというのを
毎日延々と繰り返しています。
バックプロパゲーション（誤差逆伝播法）でもご存知のように
人は失敗することでしか学習できないのです。
Claudeでのコーディング：ネクストエンジンAPI認証編
でも書きましたが、
----------------------------------------
あらゆる興味に対して勉強する姿勢で失敗は決して無い。
失敗はやり遂げられなかったという事実によって発生する。
----------------------------------------
間違いを恐れない。
諦めたことこそが失敗であり、
やり遂げたことこそが人生の成功体験である。
----------------------------------------
と私は思っていますし、
そうであることを信じています。
----------------------------------------
閑話休題
考えてみるとたしかに、認証を乗り越えて在庫数の取得までは進んだように思います。
ですが、ClaudeのArtifactsは当時の(と言っても2週間ほど前の)GeminiやGPTにはありませんでした。
GeminiやGPTには更にバグが発生した際の、デバッグ能力も不足していました。
GeminiやGPTやGitHub Copilotにはバグが発生した際にコーディングを修正するという機能はありますが、Claudeはコードの中にエラーログを残すコーディングを行うことで、デバッグ能力が飛躍的に上がるのだと思いました。
途中まで上手くいったのに、機能を追加したことによりバグが発生したことに対してバージョン管理をしたいという欲求がとても高まってきて、
GitHub Copilotで使用したVS Codeを使うことで、
バージョン管理を行いながらオープンソース化することが出来ると学びました。
しかも、一人で大規模なプロジェクトを行うというのは現実的に不可能なことに対して、世の中で行われていることというのを学んで、GitHubの必要性に迫られました。
ですが、GitHubだけでは私のような初心者に使いこなすことは難しいと感じて、VS CodeとGitHubを組み合わせて使いやすい環境を整えることにしたわけです。
VS CodeとGitHubの組み合わせはたまたま上手く言っている状況なので、それを記事にするには中々ハードルが高いのですが・・・
考えたらGitHubだけでも記事にするには中々ハードルが高いですね^^;
どちらも大規模プロジェクトに対応出来るツールですからね^^;
と言うものの、たまたま上手く言っている今の状況をフル活用して
引き続き開発を進めたいと思います。
--------------------------------------------------
在庫情報取得.gsにより200件の在庫情報の取得を行うことが出来るだけでも凄いと思ますが、
それが出来たことで今日一日で開発が一気に進みました。
しかし、在庫情報取得.gsでは200件程の在庫情報取得が上限になりました。
もっと沢山の在庫情報を取得したい！
と言う欲求から更に新しいスクリプトの開発を行うことにしました。
これが、
在庫情報取得_高速版.gs
です。
これは上記とスクリプトではない、別の改良版スクリプトです。
1回の取得件数が200行ほどという状況から、
プロンプトエンジニアリングを行うことで、
今日の午前中だけで1回のスクリプトで今までより1.5倍の在庫情報が取得できまして、
取得できなかった在庫情報も次に同じスクリプトを実行することで、
前回取得できた最終行の次の行から取得することが出来るようになりました。
これが、
在庫情報取得_高速版.gs
です。
一気に進んで大事なことなので2度言いました(笑)
また、最終行まで取得できたら
次の実行の際には最初から取得するというスクリプトになりました。
これが今日の午前中で出来た内容です。
--------------------------------------------------
ですが、GASの制限を鑑みると
在庫情報取得_高速版.gs
でも制限に接触することが見込まれたので、
Claudeに対して
一部を抜粋して
--------------------------------------------------
例えば、数十の商品コードをネクストエンジンに渡して、一気に在庫情報を取得するというようなスクリプトを書くことは可能ですか？
--------------------------------------------------
というプロンプトエンジニアリングを行うと・・・
商品マスタAPI（/api_v1_master_goods/search）を使った方法：
商品コードを配列で渡すことで、複数商品の情報を一度に取得できます。一回のAPIコールで最大100件程度まで処理可能です。
と回答してくれました。
おぉ～(・・;)
それが実現できるとスクリプトの実行時間の大幅な短縮に繋がります。
で、午後のかかりの1時間ほどで実現可能になりました^^;
これが、
在庫情報取得_一括処理版.gs
です。
3000行の在庫情報取得がわずか2分ほどで取得可能になりました(・・;)
これならば普段使いの見込みが経ってきました。
すげ～な(・・;)
このスクリプト・・・
売り物になるんじゃないんですかね？^^;
当初からオープンソース化する予定でしたので、
もう一度はじめからプロジェクトを作成するところから
Qiitaで説明書を作成するつもりですが、
会社がなんていうかわかりませんが・・・
言ってもわからない可能性がとてもありそうな予感^^;
わかってくれなくて難癖つけられても、
無料枠での制限がかけられるのでオープンソース化が最適だと思います。
と報告するつもりです。
途中から内容が詰め込まれすぎましたので、
別のブログにて発表したいと思いますm(_ _)m
ちょっと前にブログを投稿しましたが、
しょっちゅう持ち出していたら、
今日はGPTとコーディングをしていました。
チェイサーを購入して、
みんカラブログはなんでも好きなことを書いて良いと認識しているので好きなことを書きます。
