LINE Notify終了のお知らせ

まずはLINE Notifyに届いた悲しいお知らせについて

何の前触れもなく（多分）LINE通知が来まして、私はクラウドソーシングの案件検索バッチの通知で使っていたのでサービス終了は結構な痛手・・

兎にも角にも通知の最後にあるリンクに何か情報があると思ってリンクをクリックしてみます

↓↓↓は同じリンクです

サービス終了の詳細を見る

ページを開いてみるとサービス終了に加えてやはりありました、代替方法の案内です

弊社サービスで利用可能な代替方法

通知を送る代替方法として、LINE公式アカウントからメッセージを送信できるMessaging APIの利用をご検討ください。Messaging APIを利用することで、一定数のメッセージを毎月無料で送信できます。料金に関する詳細は、「Messaging APIの料金」を参照してください。

Messaging APIで利用できる機能の詳細は、「Messaging APIドキュメント」の各ページを参照してください。

https://notify-bot.line.me/closing-announce

と言うことで”Messaging API“を使う手続きを調べます！

Messaging APIを利用するために色々登録する

Messaging APIを利用するためには最終的に公式チャンネルの作成が必要になるようでして、そこに至るまでに諸々登録らしく順番に対応していきます

LINE Developersコンソールに登録

いつの間にやらDevelopersサイトがリニューアルされてましたが・・兎にも角にもログインをしてみます

※LINE Notifyを利用していた前提なので個人アカウントで登録しているものとして進めます

DevelopersサイトからまずはLINE Developersコンソールに登録していきます

プロパイダーの作成

続いてプロパイダーを作成します

LINE Developersコンソールに登録完了した画面と同じですがデベロッパートップ画面にある”新規プロパイダー作成”ボタンから登録処理していきます

Messaging APIチャネル（LINE公式アカウント）の作成

次はチャネルを作成します※結果、LINE公式アカウントを作成します

色々と項目がありますが個人利用なのでとりあえず適当に

LINE Notifyの代替になる機能を探す

ようやく本題に入ります

“Messaging API“には多くの機能がありそうですが今回は”LINE Notify“の代替として自分宛に通知する方法を探します

まずはMessaging APIの有効化

Pythonでプッシュ通知用のプログラムを作る

必要な諸々の登録が終わったので遂にPythonのプログラムを作ります

まず必要なパッケージのインストールを

pip install line-bot-sdk

続いて自分に通知するためだけの最低限のプログラムがコチラ

def line_message_api (message: str, user_id:str ='{自分のユーザーID}'):
    '''
    LINE Messaging APIを使って通知する
    '''
    # アクセストークンの設定
    CHANNEL_ACCESS_TOKEN = '{自分のアクセストークン}'
    # LINE Bot APIのインスタンスを作成 
    line_bot_api = LineBotApi(CHANNEL_ACCESS_TOKEN) 
    # メッセージを送信 
    line_bot_api.push_message(user_id, TextSendMessage(text=message))

プログラム自体は短いですが必要な値は”ユーザーID”と”チャンネルアクセストークン”の2つ

それぞれLINE Developersサイトにあるので取得しに行きます

“ユーザーID”の取得箇所

“チャネル基本設定”タブ画面の下部に表示されている”あなたのユーザーID”項目の”Uで始まる33桁の英数字“がユーザIDです

“チャンネルアクセストークン”の取得箇所

“Messaging API設定”タブ画面の下部に表示されている”チャネルアクセストークン”項目の”英数字記号“がアクセストークンです

実際にプログラムを実行してみた結果

こちらがLINEのトーク画面です

公式アカウントの記号付きでチャネル名になっていて、メッセージが反映されていることを確認できます

あとがき

LINE Notifyに比べると手順が多くお手軽とは言えないですが、LINE通知は他に変え難い便利さがあるので個人的にはこれぐらいなら許容範囲内

せっかくLINE公式アカウントを作ったのなら他にも使い道は多くありそうなので時間見つけて活用方法探したいですね

GetItemを使ってるとエラーが

先日、自作したExcelで商品情報取得するツール使っていたら見慣れないエラーが・・・

レスポンスの中身を見るとコチラが

ErrorCode:932
LongMessage:Auth token is hard expired, User needs to generate a new token for this application.

私は英語が苦手なのですぐにGoogle先生に翻訳を頼んだのですが、日本語版がコチラ

認証トークンの有効期限が切れています。ユーザーはこのアプリケーション用に新しいトークンを生成する必要があります。

今まで一度も有効期限切れエラーなんて発生したことないのに何で！？

と思いましたが原因と対応方法はわかりやすいエラーで、メッセージに書いてある通りおとなしく”新しいトークンを生成“します

トークンを再作成する

やり方は簡単で下記手順の通り

最初に同じことやってるはずなんですが正直忘れてました

APIの取得手順をブログに残しておいて良かったと過去の自分をほめてあげたい

あとがき

今回突然エラーになりましたが、これは本当に単純な有効期限切れですかね？

findItemsAdvanced終了のお知らせもあったので何かeBay側で発生してる気もします・・

Finding API終了の知らせ

作っちゃえば運用するだけのツールなんで久しく開いてなかったリファレンスページを開くと見慣れないメッセージがあったので早速翻訳した結果がコチラ

注: Finding APIのすべての呼び出しは非推奨になっており、2025 年 2 月 5 日に廃止される予定です。この API の代替として、高度な検索機能も備えたBrowse APIがあります。

https://developer.ebay.com/devzone/finding/callref/finditemsadvanced.html

いつの間に非推奨！？そして廃止予定！？

このFinding APIはセラーID等から商品一覧を取得できるfindItemsAdvance含まれていて、このfindItemsAdvanceは私がeBay関係で受注した案件でも番多く利用してきたのでなかなかの衝撃

私は自身eBayを利用していないのですが、過去発注いただいたクラインとから修正依頼あるかもしれないしこれからもeBayのツール作成を受注する可能性あるんで新しいBrowse APIを見ていきます

Browse APIについて

早速リファレンス画面へ

https://developer.ebay.com/api-docs/buy/browse/resources/methods

developer.ebay.com

（なんとなく画面のテイストが変わった気がしますが）大きく分けてitem_summary、itemの2つににカテゴライズされてそれぞれ2つ、5つのAPIが準備されていますがその中でもよく使いそうなものをピックアップ

search

おそらくこれがfindItemsAdvanceの代替になる

キーワード検索の他、フィルターで抽出結果のフィルタリングとかできそうなのでこれを注視していく

getItem

Trading APIの方にあるGetItemの代替っぽい

Trading APIは特に終了のお知らせはないので継続利用しても問題ないと思うのですが、新しいBrowse APIに準備されているので今後は新しくツールを作らならコチラを使うようにした方が良さそう

ItemIDを指定すると商品の詳細が取得できるシンプルなAPI

getItems

getItemの簡易版を最大20個を同時に取得できる

どうせならgetItemで詳細情報収集した方がいい気もしますが 5,000回/1日 の制限があるのでこっちで必要情報が間に合うならこちらを推奨

searchでfindItemsAdvanceを再現できるのか

本題のFinding APIが使えなくなった時の代替になるかの検証ですが、条件は今までの受注経験から”SellerIDベースで一覧取得できるか“で、結論から言うと

searchではSellerIDを条件に情報収集できません

正確には”SellerIDだけを条件に取得できない”なので近い条件では取得できる可能性はありますが指定したSellerIDの全商品の取得は2024年6月現在では確認できませんでした

とは言え、公式がBrowse API（item_summary）への移行を推奨しているので使い方のまとめと完全再現できないと判断した理由をまとめていきます

item_summaryをPythonで実行する

大きく分けて”request headers”と”Resource URI”の二つを設定してAPIを投げます

request headersについて

まずはrequest headersから

Request components | eBay Developers Program

developer.ebay.com

headers = {
    'Accept': 'application/json',
    'Accept-Charset': 'utf-8',
    'Accept-Encoding': 'gzip',
    'Accept-Language': 'en-US',
    'Authorization': 'Bearer {accessToken}',
    'Content-Type': 'application/json',
    'Content-Language': 'en-US',
}

findItemsAdvanceでは”App ID”を必要としていましたが、item_summaryでは”accessToken”が必要らしい

“accessToken”とは何と言われるとhttps://developer.ebay.com/my/keysから遷移した先にある”Get OAuth Application Token”で表示される画面びっしりの文字がトークンになるのでポップアップの最下部にある”Copy Token”でトークンをコピーすればそれがaccessTokenになる

念のため書いておくと”Bearer “の後ろにトークンを貼るのでAuthorizationだけ抜粋すると↓のような感じに

'Authorization': 'Bearer v^1.1#i^1#f^0#r^0#p^1#I^3#t^H4sIAAAAAAA・・・',

その他は基本固定で良さそう

Resource URIについて

続いて各パラメータについて

search: eBay Browse API | eBay Developers Program

developer.ebay.com

resource_uri = R'https://api.ebay.com/buy/browse/v1/item_summary/search?'
uri_para = {
    'q': <string>,
    'gtin': <string>,
    'charity_ids': <string>,
    'fieldgroups': <string>,
    'compatibility_filter': <CompatibilityFilter>,
    'auto_correct': <string>,
    'category_ids': <string>,
    'filter': <FilterField>,
    'sort': <SortField>,
    'limit': <string>,
    'offset': <string>,
    'aspect_filter': <AspectFilter>,
    'epid': <string>,
}
# 設定したクエリパラメータを追加する
resource_uri += urllib.parse.urlencode(uri_para)

指定できるものは多いけど実際に必要そうなものは数える程度

注意点をいくつか抜粋

1. 「q」、「category_ids」、「epid」、または「gtin」クエリ パラメータが必須
   ※Error Code:12001参照
2. <FilterField>はhttps://developer.ebay.com/api-docs/buy/static/ref-buy-browse-filters.html参照
3. selleridの指定は<FilterField>の中にある

findItemsAdvancedでもitemFilterで制限していたので似たような制御のようで1.の必須パラメータが邪魔して全件取得ができないのがsearchの問題点

itemFilterをパラメータにしてもらえれば欲しい情報が取得できそうなラインナップなのが残念ポイントで、キーワードを設定した検索で良ければ取得できそうだけどそうじゃない感

あとがき

eBayを利用した物販やっている人はfindItemsAdvanceを使って特定セラーの情報を収集するツールを使っているイメージなので2025年2月5日は衝撃の日になりそう

時間ができたらもう少しBrowse APIを調べてみたいです（需要ありそうだし）

Pythonで毎日自動処理するプログラムをいくつか作っているのでその紹介です

24時間365日稼働させるためには相応の環境が必要で、私はWindows Serverを使っていますので同じように全自動環境が欲しい方は下記を参考にしてみてください

【Windows Server】全自動に向けてWindows Serverを契約する

24時間365日稼働できるPC環境があると今手作業でやってい...

javeo.jp

2024.01.13

処理の全貌

まずは概要説明

どんな処理をしているのか文字起こしするとこんな感じ

1. 毎朝8時にプログラムを定時期実行させて以降の処理を実行
2. ポイントサイトのモッピーに対してクローリング実行
3. スクレイピング結果は自分のブログサイト（Xserver）のデータベースに保存
4. 新規案件とポイントの増減した案件を前日比較して絞り込み
5. 絞り込み結果からブログ用のページを作成して投稿
6. 絞り込み結果からXへポストする
7. LINEで自分に処理完了を通知

ポイントサイトについて深掘りはしないのですが、クローリングから始まる一連の流れを自動化してるよって目線で見ていただけると

↓↓でもう少しだけ細かく説明します

毎朝8時にプログラムを定時期実行させて以降の処理を実行

Windows Serverを使っているのでWindows PCと同じようにタスクスケジューラを使えば定期実行の設定が簡単にできます

※詳しくは↓↓↓を見てもらえればわかるはず

【Python】タスクスケジューラで定期実行する

「毎日決まった時間に～」とか、「10分間隔で繰り返し～」など...

javeo.jp

2023.10.23

設定次第で毎日決まった時間に実行したり、1時間毎に実行したりと好きなように繰り返し実行できます

ポイントサイトのモッピーに対してクローリング実行

モッピー自体に興味がある人は少ない気がするので詳細は割愛しますが、Pythonを使えばWEBサイトから欲しい情報を収集してリストアップすることが可能です

※クローリングに興味のある方は私のプロフィールからクラウドワークスやココナラでご相談ください

クローリング結果は自分のブログサイト（Xserver）のデータベースに保存

取得した情報の一部がこんな感じ

サーバーの中のデータベースに保存することでWeb画面から検索をかけたりすることが可能になるので結構使い勝手が良いです

実際にこのデータを使っているページが↓

500 Internal Server Error

point.javeo.jp

新規案件とポイントの増減した案件を前日比較して絞り込み

データベースにデータ保存してあればSQL（もっと言えばビューですが）を使って前日比較することが簡単になります

細かく言うと 「追加・削除・値の増加・値の減少」で、それぞれ秒で前日比較することもできます

絞り込み結果からブログ用のページを作成して投稿

Python使えば比較的簡単にWordpressに記事投稿できるんです

きっとAIを使えば文章もいい感じに可変にできる気もしますが今はそこまでの熱意が無いので文章は定形、↑で収集した前日比較の値から作成するテーブルを可変部分で毎日投稿しています

毎日投稿しているサイトは↓です

500 Internal Server Error

point.javeo.jp

絞り込み結果からXへポストする

Pythonを使えば簡単にX（旧Twitter）にポストすることもできるんです

これまでよろしく、前日比較してポイントのUP・Down、新規広告をカウントしてポストの文章作ってWordpressの記事のURLを記載してポストしています

毎日ポストしているbotアカウントがこちら↓

LINEで自分に処理完了を通知

最後にサーバー側のメンテンナンスとかで稀にプログラムが実行されないことがあるのでPythonでLINE通知して終了

通知方法は↓↓を参照

https://javeo.jp/line_notify/

javeo.jp

ちなみに、途中でエラーがした場合はエラーを通知するようにしています

あとがき

色々手が込んだ作りにしたんですが、正直ポイントサイトに興味がある人があまりいないイメージなので、改めてまとめるとココまでやる意味とは！？と自問自答しています

なんですが、Windows Serverなど環境を整えればPythonでこんなことを全自動で毎日実行できる一例になったのでそこには価値があったと思っています

他にもいくつかWindows Serverで実行していることがあるのでどこかで紹介していきます

APIの利用に必要なもの

まず最初にプログラムのなかで必要なパラメータが2つありまして

• APIトークン
• ルームID

の取得方法をご紹介

APIトークンを取得

ログイン後に右上にあるアカウント名をクリックして表示されるメニューの中から”サービス連携“をクリック

ChatworkのWEBページへ飛ぶので左側のメニューで”APIトークン“をクリックするとAPIトークンが表示される画面に遷移するのでコピー

ルームIDを取得

次はメッセージを送りたいルームを指定するために対象のルームIDを取得します

①”通知対象にするグループチャット“をクリックしてアクティブにしておく
②”右上の歯車のアイコン“をクリック
③”グループチャットの設定“をクリック

の順にメニュー遷移する

グループチャットの設定画面左下に”ルームID“が表示されているので控えておく

Pythonのプログラム

肝心のPythonプログラムがこちら

公式ページのソースをちょっと弄っただけですが、bool型にしてステータスコードが200かどうかでTrue・False判定してます

import requests

# messageの引数だけでも通知できるように初期値の設定
CHATWORK_TOKEN = '********************************'
CHATWORK_ROOM_ID = '999999999'

def send_to_chatwork(message, chatwork_token=CHATWORK_TOKEN, room_id=CHATWORK_ROOM_ID) -> bool:
    headers = {"X-ChatWorkToken": chatwork_token}
    url = f"https://api.chatwork.com/v2/rooms/{room_id}/messages"
    payload = {
        "self_unread": 0,
        "body": message
    }
    headers = {
        "accept": "application/json",
        "content-type": "application/x-www-form-urlencoded",
        "x-chatworktoken": chatwork_token
    }
    response = requests.post(url, data=payload, headers=headers)
    if response.status_code == 200:
        return True
    else:
        return False

import requests

# messageの引数だけでも通知できるように初期値の設定
CHATWORK_TOKEN = '********************************'
ROOM_ID = '999999999'


def send_to_chatwork(message, token=CHATWORK_TOKEN, room_id=CHATWORK_ROOM_ID) -> bool:
    headers = {"X-ChatWorkToken": token}
    url = f"https://api.chatwork.com/v2/rooms/{room_id}/messages"
    data = {"body": message}
    response = requests.post(url, headers=headers, data=data)
    if response.status_code == 200:
        print("Message sent successfully.")
        return True
    else:
        print("Failed to send message.")
        return False


def main():
    message = 'テスト通知'
    send_to_chatwork(message, '5cbc320450032388263d0073b7473a54', '331928429')


if __name__ == "__main__":
    main()

Chatwork上でメッセージを送信した時と同じようにプログラムでメッセージ送信されている

通知結果

↓のようにAPIトークンを発行したユーザーでメッセージを送ることができます

公式ドキュメント

公式ドキュメントはいくつかありますが、↓が簡易テストもできてわかりやすいです

Chatwork APIドキュメント

クラウド型ビジネスチャットツール「Chatwork」における...

developer.chatwork.com

あとがき

LINEの通知プログラムも作りましたが仕事で使おうと思うとするとChatworkの方が利用シーン多いと思って作ってみました

気が向いたらTeams版も作ろうかと思います

LINEの通知プログラム

LINEの通知プログラムはコチラからどうぞ

※LINE Notifyは2025年3月で終了しました

404 NOT FOUND – 実務者向けのExcelとPythonとか

ほどほどレベルのプログラミング

javeo.jp

副業でTwitterのAPIを使う機会があったので取得方法を備忘でまとめてみました（都合2アカウント分、つまり2回取得しています）

調べてみると申請画面や項目は結構な頻度で変わるみたいで、この記事は2022年10月現在の申請方法になりますのでその前提で参考にしてみてください

申請画面は英語多めで苦手な方（私）向けに画面多めで構成してますので縦長になりましたがその分伝わりやすいと思うのでご了承を

（一応レベルの事前準備をお伝えするとツイッターのアカウントは事前に作成しておいてください）

事前準備編

まずはTwitterへログイン

X開発者プラットフォーム

ツイートの公開と分析、広告の最適化、独自性のあるカスタマーエ...

developer.x.com

兎にも角にもまずはログインから

Googleアカウントに連動してたっけ？と思いつつ連動してれば簡単にログインできます

そしてなぜかリダイレクト先が開発者用ではなくて普通のTwitter画面に、、、

ついでにPC版のTwitter言語を日本語に

PC側だと初期値が英語設定になっていたので日本語に直します（私だけですか？）

たいした話ではないのでさらっと

①more →　②Settings and Support　→　②Settings and privacy　→　④Accessibility, display, and languages　→　⑤Languages　→　⑥Display language　→　⑦Change display language　で　”Japanese – 日本語”を選択して右下の”Save”を押下

開発者プラットフォームで今度は”Sing up”

Twitterにログインできているとヘッダーのメニューが変わっているので今度は”Sing up“を

URLを見ればわかるのですが以降のメニューは英語圏しか準備されていならしく言語が英語に・・・（英語が苦手な私はGoogle先生に翻訳してもらって進めました）

聞かれてることは大したことではないので適当に登録して”Let’s do this“を押下

次ページは利用規約の同意なので気になる人は一読した後に”Submit“で利用規約に同意を

（このあとTwitter開発者用アカウントからメールが届くのでメール内のリンクから続きを）

（Twitterアカウントに電話番号が登録されていないと弾かれる）

利用規約同意しようとしても画面が変わらず・・・右上を見るとどうやらTwitterアカウントに電話番号登録が必要とのことなので一度Twitter側の画面へ

（先ほど日本語化しているのでわかりやすい！）

もっと見る　→　設定とサポート　設定とプライバシー　→　アカウント　→　アカウント機能　→　電話　で登録を（この後SNS認証などありますが省略）

終わったら改めて”Submit“で利用規約に同意を

開発者ポータル編

ようやく開発者ポータルでの作業へ移ります

アプリ名の設定とAPIキーの生成

まず最初にアプリの名前を登録を要求されるので適当に登録（後から変更できます）

すると早速”API Key / API Key Secret / Bearer Token“生成さます！が、さすがにここで終わりってことはなくAPIの利用にはまだまだ必要なものがあるのでダッシュボードへ

アクセストークンを生成

ダッシュボードのトップページにある鍵のアイコンからAPIキーとトークンの管理画面へ

一番下がアクセストークンなので”Generate“をクリック

すぐに”Access Token / Access Token Secret“が生成されるので”Yes, I saved them“で確定

ユーザー認証設定してクライアントIDを取得

左部のメニューから”Projects & Apps → Project 1 → <最初に設定したアプリ名>“のメニューへ移動して設定画面へ

初の縦長メニュー

最後の”App info“が曲者ですが各項目を選択＆入力してクライアントIDを生成する

一応レベルですが各項目の説明は画像の下に用意しています

App permissions

“Read“だとツイートできず私の目的は達成できないので”Read and write“を選択

きっとAPI使ってDMまでしたい人は”Read and write and Direct message“が必要なのでしょう

“Request email from users“はよくわからない＆使い道なさそうなのでOFFのまま

Type of App

選択肢による動作の違いは正直わかってません・・・

私の目的は自動ツイート用のbotかつパブリックにする意味もないので”Web App, Automated App or Bot“を選択

App info

ここが一番よくわからず・・・

結果論として私が登録したのは必須の”Callback URI / Redirect URL“と”Website URL“の2つだけ

この項目は諸説ありまして、調べた限り

• 両項目に自分が運営しているサイトのURL
• “Callback URI / Redirect URL“には”https://127.0.0.1:3000/cb“
  “Website URL“には自分のTwitterURL（私なら “https://twitter.com/javeo2022“）

のどちらか

私は両方のパターンで申請しましたがどちらでも問題ない実績があります

全て入力して”Save“押下すると”Client ID / Client Secret“が生成されます

Pythonで利用するならもう一歩！

私はPythonでAPIを利用するので”tweepy“を使うわけですがもう一つ対応することがあります

ツイートするAPIの問題なのかtweepyの仕様なのかわかりませんが言われてことを

まだまだ終わらない、アクセス権が不足している？

この段階でアイテムとしては準備できているので早速APIでツイートしてみるとエラーが（わかりやすいのでVSCodeでのエラーメッセージから引用）

（原文）
403 Forbidden
453 – You currently have Essential access which includes access to Twitter API v2 endpoints only. If you need access to this endpoint, you’ll need to apply for Elevated access via the Developer Portal. You can learn more here: https://developer.twitter.com/en/docs/twitter-api/getting-started/about-twitter-api#v2-access-leve

英語読めないので翻訳サイトさんに助けてもらうと”Elevatedアクセスに申請する必要があります”と言われたので再び開発者ポータルへ

どうやら今のままでは”Essential”の状態なので”Elevated”へ申請する必要があるとのこと

Essentialでは”Twitter API v2″が利用できるけどtweepyで利用しているのが”Twitter API v1.1″とのことでこの対応が必要らしい

Elevatedへの申請をする

開発者ポータルの左部のメニューから”Products → Twitter API v2 → Elevatedタブ“の順で遷移して”Apply“を押下

名前と国はプフィールから初期値として引用されている（と思う）ので”スキルレベル“を選択して”アップデート通知”は必要なら

ここが一番だるい

各設問に対して”英語“で入力する必要があります

私は英語力皆無なのでDeeL翻訳様の力をお借りしまして必要な各項目登録しました

ちなみに各詳細項目でNoにした場合の影響はわかりません（正直）

各コメントも適当に登録した時の影響がわからないので正直に回答します

How will you use the Twitter API or Twitter Data?

この項目は必須

利用目的を”英字200文字以上”で述べる必要があるのでそれらしい文章を入力します

参考になるかわかりませんが日本語と実際に入力英語の文章を

今予定している利用目的は2つあります
毎日あるポイントサイトの変更点を探し、その差分をツイートするbotを作りたいです
自分をフォローしてくれた人を自動的にフォローバックしたいです
使い慣れればデータ分析など活用の幅を広げたいと思っています

There are two purposes of use that I’m planning right now
I want to create a bot that looks for changes to a certain point site every day and tweets the differences!
I want to automatically follow back people who follow me!
Once I get used to using it, I would like to expand the scope of its use, such as data analysis.

Are you planning to analyze Twitter data?

私は今のところデータ分析の予定はないのでNoに変更

Yesなら”英字100文字以上”で入力

Will your App use Tweet, Retweet, Like, Follow, or Direct Message functionality?

利用目的とほぼ同じこと言ってますがこれが利用目的なのでその通りに

こちらも参考になるかわかりませんが日本語と実際に入力英語の文章を

とあるポイントサイトの変更点を探して、その差分をツイートするbotを作りたいです
フォローしてくれた人に自動でフォローバックしたいです
今はリツイート、いいね、DMの利用はありません

I want to create a bot that looks for changes to a certain points site and tweet the differences!
I want to automatically follow back those who follow me!
No retweet, like, or DM use right now!

Will your product, service, or analysis make Twitter content or derived information available to a government entity?

どこに情報提供する予定なんてないのでここもNoへ

レビュー画面を挟みますが問題なければ次へ

最後に開発者契約とポリシーに同意して終了

あとがき

実際に申請してもらうとわかるんですが最後のElevatedの申請はSubmitした瞬間から使えるようになるので利用目的とかちゃんと入力する意味あるのかなと思いつつも後から利用できなくなるとつまらないのでちゃんと入力しました

実際に使用しているbotは↓なので気が向いたら見てみてください

eBayのAPIキー取得は無料なのはいいけどサイト内が全て英語で日本語しかわからない私がGoogle先生に翻訳いただきながら取得したので、その手順とかを後世に残そうとメモを残すのである

最後に記述しますがWEBサイト持ってないとトークンが取れないようなのでご注意を

アカウント登録する

ログイン＆アカウント登録はコチラのURLから

Sign in or Register | eBay Developers Program

developer.ebay.com

新規登録なので「Register」タブをクリックして各項目を入力するだけ
パスワードは8文字以上64文字以下で英数字記号を全て使いなさいと書いてあるのでその通りに

メールが届いて24時間以内にクリックせい！とおっしゃられるのでその通りに

審査に1営業日以上かかるらしいので終わるのを待ちましょう

アカウントができたのでAPIキーを取得

改めてログインページ

ログインしたらまだApplication Keysが無いので取得する
「Enter Application Title」に好きなAPIセット名を入力すると「Sandbox」と「Production」の枠が出現する
「Sandbox」は「Create a Keyset」をクリックするだけで生成できるけど正直使い道はない

「Production」側の「Create a keyset」をクリックして出現してきたダイアログの各項目を入力して「Continue to Create Keys」をクリック

これでAPIキー作成完了！と思いきや枠だけ出現して無効化されてる状態・・・
有効化するために「marketplace deletion/account closure notification」をクリックして次の手順へ

まずは通知先のメアド登録
ここはメアド登録して「Save」をクリックするだけの簡単なお仕事

左下に登録ができたメッセージが表示されて入力部分が非活性・ボタンがEditボタンに

次にエンドポイントのURLと検証用のトークンを入力するのですが、この準備がちょっと長くなるので別ページにまとめました

eBayのAPI取得のためのエンドポイント作成方法

eBayのAPIは2021年9月からエンドポイント設置が必要...

javeo.jp

作成したエンドポイントURLとVerification tokenを入力してSaveをクリック

左下に登録ができたメッセージが表示されて入力部分が非活性・ボタンがEditボタンに

画面を戻すと「App ID／Dev ID／Cert ID」がそれぞれ取得できている

最後にトークンを取得

各キーが取得できて終わりと思いきやeBayのAPIの中にはさらに認証トークンが必要なものもあるのでそれも取得しておく

先ほどの画面から「User Tokens」をクリック

左下の「Sign in to Production」をクリック

アカウント情報に不足があると登録を求められるので登録する

続いてeBayのアカウント（Developers ProgramじゃなくてECサイトのeBayの方っぽい）でサインイン

私は持ってなかったので新規登録

同意を求められるので同意

画面が戻ってきて完了メッセージとともに有効期限と認証トークンが表示されている

あとがき

長い！そして全部英語のページは学のない私には正直辛かった・・・

取得は無料なんだけどサーバー準備しないといけないので実質有料だったり、最初の承認に1営業日以上必要だったりとなかなかスムーズにいかない部分があるのはマイナスポイント

エンドポイントを作る前に

まずはワークフローページから

https://developer.ebay.com/marketplace-account-deletion

developer.ebay.com

ワークフローページ内にエンドポイントを求める理由やエンドポイントの作り方などなど書いてあるので興味があれば読んでみてどうぞ

サーバーについて私はXserveを契約しているのでそのやり方を書きます

受信プログラムを作る

ワークフローページに盛り込む項目や条件、「Node.js／Java／Python／C#／PHP」それぞれのコードスニペットが書いてあるのでGoogle翻訳を駆使して作ります

まず必要な内容として

• GET呼び出しの形式でchallenge_codeを受け取るように作る
• エンドポイントURLは「https」プロトコルを使用する必要がある
• パスに内部IPアドレスまたは「localhost」が含まれていてはならない
• ヘッダーに’application/json‘を設定してJSON形式でレスポンス：200とchallengeCode + verificationToken + endpointの順でハッシュした値を返す
• verificationToken は32〜80文字で英数字＋アンダースコア（_）、およびハイフン（-）で作る
  ※verificationToken のパスワード生成は↓↓なんかを活用

パスワード生成（パスワード作成）ツール

パスワード生成（パスワード作成）するweb・ウェブ制作に役立...

www.luft.co.jp

Passwords Generator

パスワードを大量に自動生成可能な無料のオンラインツールです。...

www.graviness.com

その結果、出来上がるファイル（PHP）はコチラ※10-16行目はコードスニペットをそのまま流用

<?php
header('HTTP/1.1 200 OK');
header("Content-Type: application/json; charset=utf-8");
$verificationToken = 'zq8mT8VSSycttCZGwRMtifqhaQMiB695swLHAt2e';
//ディレクトリとファイル名はお好きなように
$endpoint = 'https://<自分のドメイン>/ebayApi/endpoint.php';

if(isset($_GET['challenge_code'])){
    $challengeCode = $_GET['challenge_code'];
    $hash = hash_init('sha256');

    hash_update($hash, $challengeCode);
    hash_update($hash, $verificationToken);
    hash_update($hash, $endpoint);

    $responseHash = hash_final($hash);
    echo json_encode(array("challengeResponse"=>$responseHash));
}
?>

Xserverの中に保存場所を作る

ディレクトリは受信プログラムに書いたのでそれと合わせる
※今回なら「ルートディレクトリ → ebayApi」

XserverでサブFTPアカウントを設定する

XserverのサーバーパネルからサブFTPアカウント設定メニューへ

エンドポイントを設定するつもりのドメインを選択

お好きなFTPユーザーIDとパスワードを設定
接続先ディレクトリはドメインをそのまま貼り付ければOK
入力したら「確認画面へ進む」をクリック

「追加する」をクリック

サブFTPアカウントの作成完了

フォルダを作って受信プログラムファイルを保存

サブFTPアカウントの一覧からログインする

サーバー内に入れたことを確認　※「public_html」がルートディレクトリ

「public_html」の下に「ebayApi」フォルダを作って受信プログラムの「endpoint.php」をアップロードする

設置完了

念のためURLを直直接叩いてワークフローページのサンプルと同じような値が返ってくるかチェック

あとがき

ファイルの設置できたらURLとverificationTokenが必要になるのでこれを控えてデベロッパープログラムに戻ってくだされ

そもそもJSONって何？

JSON（JavaScript Object Notation）は、テキストベースのデータ交換フォーマットです。Web APIからデータを取得する際など、様々な場面で利用されています。

JSONの基本構造と記述ルール

• 項目は必ず””（ダブルクォーテーション）で囲む
• 文字列は必ず””（ダブルクォーテーション）で囲む
• 数値は小数点型を含めてそのまま表記
• 真偽値（Boolean）は「true、false」のどちらか　※小文字、””は付けない
• Null値は「null」　※小文字、””は付けない
• 『[]』の配列内も上記と同じルール

「<key>: <value>」 の形式が基本で、複数のデータを {} で囲んで「オブジェクト」として、また、順序のあるデータのリストを [] で囲んで「配列」として表現します。軽量で人間にも機械にも読みやすいのが特徴です。

他にも細かな点はいくつかありますが、本格的に覚えるならWEB系をやる時で大丈夫かと。

JSONデータのサンプル

CSVほど一見でわかる形式ではないのでサンプルと共に見方の説明になります

例えばこんなJSON形式のデータがあるとして

[{"name":"Javeo","birthdate":{"year":2000,"month":1,"day":1},"height":180,"weight":70,"favorite_foods":["Meat","Vegetables"],"glasses":true},{"name":"Javelin","birthdate":{"year":2002,"month":2,"day":2},"height":150,"weight":null,"favorite_foods":["Sweets"],"glasses":false}]

よく見るわかりやすい形にすると・・・※VSCodeなどツールを使えば簡単に変換できます

[
  {
    "name": "Javeo",
    "birthdate": {
      "year": 2000,
      "month": 1,
      "day": 1
    },
    "height": 180,
    "weight": 70,
    "favorite_foods": [
      "Meat",
      "Vegetables"
    ],
    "glasses": true
  },
  {
    "name": "Javelin",
    "birthdate": {
      "year": 2002,
      "month": 2,
      "day": 2
    },
    "height": 150,
    "weight": null,
    "favorite_foods": [
      "Sweets"
    ],
    "glasses": false
  }
]

これをEXCEL的に表にするとこうなります

つまりJSONをざっくり説明すると必ず項目と値が対になっていて、『｛｝』が階層を『[]』は配列のデータ群になっていると思えばOK

VBAでJSONを扱う準備をしよう！

VBAには標準でJSONを扱う機能がないため、オープンソースのライブラリ「VBA-JSON」を導入します。

「VBA-JSON」の導入手順

導入までは3STEPで完了します

VBAでJSONを解析（パース）してみよう

JSON形式のテキストデータをVBAで扱えるデータ構造（DictionaryオブジェクトやCollectionオブジェクト）に変換することを「解析（パース）」と言います

JsonConverterモジュールにある ParseJson 関数を使えば、この処理が一行で完了します

ということでサンプルコードを

' /// 事前準備 ///
' VBEの [ツール] > [参照設定] から下記2つにチェックを入れてください
' 1. Microsoft ActiveX Data Objects 6.1 Library (バージョンは環境により異なります)
' 2. Microsoft XML, v6.0
Sub GetJsonData()
    Dim http As MSXML2.XMLHTTP60
    Dim jsonText As String
    Dim parsedData As Object ' 解析後のデータ格納用

    ' Web APIからJSONデータを取得（例）
    Set http = CreateObject("MSXML2.XMLHTTP")
    http.Open "GET", "https://javeo.jp/wp-json/test/v1/data", False
    http.send
    jsonText = http.responseText

    ' ★★★ ここがポイント！JSONを解析 ★★★
    Set parsedData = ParseJson(jsonText)

    ' 解析したデータをデバッグ出力
    Debug.Print "名前: " & parsedData(1)("name")
    Debug.Print "体重: " & parsedData(1)("height")
    
    ' 配列のデータを取り出す
    Set http = Nothing
    Set parsedData = Nothing
End Sub

結局VBA-JSONを使ってる箇所はこの一行だけ

Set res = ParseJson(.responseText)

でもこの一行がないと一番最初のただの長い文字になってしまうところをこんな感じで要素を指定してデータを取り出すことができます

VBAオブジェクトをJSON文字列に変換（生成）

逆に、VBAのDictionaryオブジェクトやCollectionオブジェクトからJSON形式の文字列を生成することも可能で、 ConvertToJson 関数を使用します

Sub CreateJsonString_Revised()
    Dim postData As Object
    Dim skillsCollection As Collection
    Dim jsonString As String

    ' データを格納する親オブジェクトを準備
    Set postData = CreateObject("Scripting.Dictionary")

    ' 基本的なキーと値を追加
    postData("name") = "鈴木 一郎"
    postData("age") = 25
    
    ' 配列用のオブジェクトを「Collection」で準備
    Set skillsCollection = New Collection
    
    ' Collectionにデータを追加
    skillsCollection.Add "Word"
    skillsCollection.Add "PowerPoint"
    
    ' 親オブジェクトにCollectionを追加
    postData.Add "skills", skillsCollection

    ' DictionaryをJSON文字列に変換
    jsonString = ConvertToJson(postData)

    ' 結果をイミディエイトウィンドウに出力
    Debug.Print jsonString
    ' 想定される出力: {"name":"鈴木 一郎","age":25,"skills":["Word","PowerPoint"]}

    ' オブジェクトの解放
    Set postData = Nothing
    Set skillsCollection = Nothing

End Sub

この jsonString をWeb APIに送信することで、VBAで作成したデータをサーバーに送ることができます

あとがき

「VBA-JSON」ライブラリを使えば、これまでVBAでは難しかったJSONの扱いが非常に簡単になります。

• JSONを解析するなら ParseJson
• JSONを生成するなら ConvertToJson

この2つの関数を覚えるだけで、Web APIとの連携など、VBAでできることの幅が大きく広がります。ぜひ活用してみてください！