前提・実現したいこと

youtubeのapiを使ってどうぶつの森にマッチする動画を収集しようとしております。
youtube data APIのサンプルコードを参考に書いています。
ですが、以下のようなエラーが発生しました。

発生している問題・エラーメッセージ

AttributeError: 'str' object has no attribute 'q'

該当のソースコード

from apiclient.discovery import build
from apiclient.errors import HttpError
from oauth2client.tools import argparser

DEVELOPER_KEY = "取得したAPIキーを入れています"
YOUTUBE_API_SERVICE_NAME ="youtube"
YOUTUBE_API_VERSION ="v3"

def youtube_search(options):
    youtube = build(YOUTUBE_API_SERVICE_NAME,YOUTUBE_API_VERSION,
        developerKey=DEVELOPER_KEY)

    search_response = youtube.search().list(
        q = options.q,
        part = "id,snippet",
        maxResults = options.maxresults
    ).execute()

youtube_search('どうぶつの森')

試したこと

AttributeError: 'str' object has no attribute 〜〜〜〜
のように続く他の方のエラーを参考に考えてみたのですが、
なぜエラーが発生しているのかが全くわかりません。
q = options.q,
の部分などqが二回出てくるコードの意味が理解できなかったため、
（サンプルなので合っているはずなんですが）
消して以下のようなコードで実行してみました。
q = options
ですが、今度は別のエラーが発生しました。
ValueError: invalid literal for int() with base 10: 'どうぶつの森'
調べて、INTの引数に１０進数で変換不能な値が入っている？と自分なりに解釈しました。
ですが、INTは今回のコードには使用していないためエラーの意味が理解できません。

以前にBeautifulSoupを使って他のサイトをスクレイピングをしていた際のことが
ふと頭に浮かんだのですが、
optionに存在するデータからさらに検索？する時点でoptionのなかにデータが存在しないため検索できず、
エラーをはくといったことと同じニュアンスなのでしょうか？

補足情報（FW/ツールのバージョンなど）

ご教授いただきたい点としましては、

１、q = options.q,のコードでqが二回出てくる意味について
２、今回のエラーを解決する糸口について

です。

よろしくお願いいたします。

行動規範の内容に同意します

回答2件

ベストアンサー

元のサンプルコードと比較して、質問のソースコードで欠落している重要な部分は以下です。（説明に不要な部分は省略しています）

if __name__ == "__main__":
  argparser.add_argument("--q", help="Search term", default="Google")
  args = argparser.parse_args()
  youtube_search(args)

このスクリプトでは、argparseと呼ばれるモジュールについての知識が必要になります。

２行目で

argparser.add_argument("--q"　・・・)

となっています。これは、たとえばスクリプト実行時に

python test.py --q どうぶつの森 --maxresults 10

とすることにより、
args に自動的に「q」と「maxresults」という属性が付与され、
args.qに、指定した文字列（ここでは"どうぶつの森"）、および args.maxresultsに指定した数値（ここでは 10）が代入されます。

１、q = options.q,のコードでqが二回出てくる意味について

意味はなく、別々の変数が同じ名前で使われており、わかりにくくなっているだけです。

1番目のqは、youtube.search().list関数で、検索対象文字列を指定するためのパラメータです。
2番目のqは、スクリプト実行時に指定した引数を格納するオブジェクト（args）の属性です。

例えば、わかりやすく置き換えるなら、エントリポイントでは

if __name__ == "__main__":
  argparser.add_argument("--queryword", help="Search term", default="Google")

とし、youtube_search()関数内で、

q = options.queryword

とします。

（サンプルなので合っているはずなんですが）

消して以下のようなコードで実行してみました。
q = options
ですが、今度は別のエラーが発生しました。
ValueError: invalid literal for int() with base 10: 'どうぶつの森'

（2020/5/13 2:00時点の質問文から引用）

ここは不正確で、q = optionsとしただけでなく、maxresults も下記のように変えましたよね？

maxresults = options

としていなければValueErrorは出ないはずです。仮にmaxResults = options.maxresultsのままならば
AttributeErrorが出るはずです。

ValueErrorが出た原因は、maxresultsに渡すデータは数値でなければいけないのに、options すなわち「'どうぶつの森'という文字列」を渡したからです。

２、今回のエラーを解決する糸口について

今回は、argparseの仕様の理解が鍵だと思います。

エラーを解析する際は思い込みを捨て、前後のコードを丁寧に調べながら紐解いていくことが必要になります。

追記

仮に元の質問のコードを修正する場合は、youtube_search()関数の内部及び呼び出し元を以下のようにすれば動くと思います。

def youtube_search(options):
    youtube = build(YOUTUBE_API_SERVICE_NAME,YOUTUBE_API_VERSION, 
        developerKey=DEVELOPER_KEY)

    search_response = youtube.search().list(
        q = options,              # 修正
        part = "id,snippet",
        maxResults = 10           # 修正
    ).execute()
    return search_response        # 追加

print(youtube_search('どうぶつの森'))  # print～ に修正。

投稿2020/05/12 16:53

編集2020/05/13 00:08