友盟愛憎情仇のOpen APIインタフェースドキュメント(python版)

10412 ワード

彼はかつて北方から来た狼だったが、なぜ最近残業犬になったのか心配している.
普段は静かな時計をしていた兄が毎日友盟からデータを導き出し、風雨に阻まれないこの日、彼は眉をひそめて発見した......ある任務は72個のexcel時計を導き出す必要がある.怠惰な彼は陣を破る術を探し始めた.
友盟は、無数のデータ製品マネージャー、データアナリストのデータ分析利器で、統計で江湖を制覇した.江湖には「友盟Open API.pdf」のドキュメントが伝わっており、本文はPython言語に基づいて、ドキュメントの大部分のデータインタフェースの呼び出しをPython関数と書き、使い勝手を期待している.
データ取得プロセスは、アカウントパスワードでtokenを取得する--tokenでappkeyを取得する--tokenとappkeyで他のデータを取得する
auth_token認証
受信パラメータ:
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
email
必須
ユーザー名
string
password
必須
パスワード
string
インタフェース呼び出しが正常にデータを返す例:{"code":200,"success":"ok","auth_token":"bgymNcCjPC 3 gY 9 TUE 241"}
#       auth_token
def authorize(user, pasw):
    url = 'http://api.umeng.com/authorize'
    body = {'email': "%s"%(user), 'password': '%s'%(pasw)}
    response = requests.post(url, params = body)
    return response.json()['auth_token']

APPリストの取得
受信パラメータ:
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
per_page
オプション
1ページあたりの数、デフォルトは20です.
int
page
オプション
何ページ目、デフォルトは1で、1から数えます
int
q
オプション
クエリーするapp名
string
インタフェース呼び出しが正常にデータを返す例:[{"name":"Android Demo App","category":"情報を読む","created_at":"2011-04-28 T 11:04:02 Z","updated_at":"2013-03-06 T 09:31:10 Z","platform":"android","appkey":"4 db 949 a 2112 cf 75 caa 00002 a"},{"name":"iPhone Demo App","categoory":"ツール","created_ed_____e":"ツール","created_ed_ed____ed___at":"2012-02-23 T 15:15:33 Z","updated_at":"2013-03-06 T 09:31:11 Z","platform":"iphone","appkey":"4f46581552701523110000c9"} ]
#  APP  
def apps(auth_token):
    url = 'http://api.umeng.com/apps?&auth_token=%s'%(auth_token)
    response = requests.get(url)
    return response.json()

APPの数を取得する——登録した友盟のアカウントの下のAPPの数
#  APP   ——         APP  
def apps_count(auth_token):
    url = 'http://api.umeng.com/apps/count?auth_token=%s'%(auth_token)
    response = requests.get(url)
    return response.json()['count']

APPの基本データを取得する——アプリケーションリスト-すべてのアプリケーション
#  APP      ——    -    
def base(auth_token):
    url = 'http://api.umeng.com/apps/base_data?auth_token=%s'%(auth_token)
    response = requests.get(url)
    return response.json()

チャネルリストの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
date
オプション
クエリー日、形式は2013-03-01、todayまたはyesterday、デフォルトはtoday
string
per_page
オプション
1ページあたりの表示数、デフォルトは10
string
page
オプション
現在のページ数、デフォルトは1
string
レスポンスフィールド
フィールドの説明
date
クエリー日(デフォルトはtoday)
total_install_rate
現在のチャネルの新規ユーザーが当日の新規ユーザーに占める割合
active_user
アクティブなユーザー
install
新規ユーザー
total_install
合計ユーザー数
channel
チャネル名
id
チャネルのid
#      
def channels(appkey,auth_token):
    url = 'http://api.umeng.com/channels?appkey=%s&auth_token=%s'%(appkey,auth_token)
    response = requests.get(url)
    return response.json()

現在のすべてのバージョンと基本データの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
date
オプション
クエリー日、形式は2013-03-01、todayまたはyesterday、デフォルトはtoday
string
レスポンスフィールド
フィールドの説明
date
クエリー日(デフォルトはtoday)
total_install_rate
現在のチャネルの新規ユーザーが当日の新規ユーザーに占める割合
active_user
アクティブなユーザー
install
新規ユーザー
total_install
合計ユーザー数
version
バージョン番号
#             
'''
def versions(appkey,auth_token):
    url = 'http://api.umeng.com/versions?appkey=%s&auth_token=%s'%(appkey,auth_token)
    response = requests.get(url);print(response.status_code)
    return response

今日の基本データの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
レスポンスフィールド
フィールドの説明
date
日付
active_user
アクティブなユーザー
installations
合計ユーザー数
launches
起動回数
new_users
新規ユーザー
#         
def today_data(appkey, auth_token):
    url = 'http://api.umeng.com/today_data?appkey=%s&auth_token=%s'%(appkey,auth_token)
    response = requests.get(url);print(response.status_code)
    return response

任意の日付の基本データの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
date
オプション
クエリー日、形式は2013-03-01
string
レスポンスフィールド
フィールドの説明
date
日付
active_user
アクティブなユーザー
installations
合計ユーザー数
launches
起動回数
new_users
新規ユーザー
#           
def base_data(appkey, date, auth_token):
    url = 'http://api.umeng.com/base_data?appkey=%s&date=%s&auth_token=%s'%(appkey,date,auth_token)
    response = requests.get(url)
    return response.json()

ユーザー・グループ・リストの取得
#       
def segmentations(appkey, auth_token):
    url = 'http://api.umeng.com/segmentations?appkey=%s&auth_token=%s'%(appkey,auth_token)
    response = requests.get(url)
    return response.json()

新規ユーザー要約の取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
start_date
必須
開始日、2012-08-15
string
end_date
必須
終了日、2012-09-04
string
period_type
オプション
日付タイプ、daily/weekly/monthly、デフォルトはdaily
string
channels
オプション
チャネルidは、4 f 6 c 5 c 4852701534 c 900007,4 f 86490752701575 f 500000 4のように分割される
string
versions
オプション
バージョン番号、以、分割、例えば1.1.0、1.1.3
string
segments
オプション
クラスタidは、4 f 6 c 5 c 4852701534 c 900008,4 f 86490752701575 f 500000 5のように分割される
string
#        
def new_users(appkey, start_date, end_date, auth_token):
    url = 'http://api.umeng.com/new_users?appkey=%s&start_date=%s&end_date=%s&auth_token=%s'%(appkey, start_date, end_date, auth_token)
    response = requests.get(url)
    return response.json()

アクティブなユーザー要約の取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
start_date
必須
開始日、2012-08-15
string
end_date
必須
終了日、2012-09-04
string
period_type
オプション
日付タイプ、daily/weekly/monthly、デフォルトはdaily
string
channels
オプション
チャネルidは、4 f 6 c 5 c 4852701534 c 900007,4 f 86490752701575 f 500000 4のように分割される
string
versions
オプション
バージョン番号、以、分割、例えば1.1.0、1.1.3
string
segments
オプション
クラスタidは、4 f 6 c 5 c 4852701534 c 900008,4 f 86490752701575 f 500000 5のように分割される
string
#        
def active_users(appkey, start_date, end_date, auth_token):
    url = 'http://api.umeng.com/active_users?appkey=%s&start_date=%s&end_date=%s&auth_token=%s'%(appkey, start_date, end_date, auth_token)
    response = requests.get(url)
    return response.json()

カスタムイベントGroupリストの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
start_date
必須
開始日、2013-01-23
string
end_date
必須
終了日、2013-02-03
string
period_type
必須
日付タイプ、daily/weekly/monthly、デフォルトはdaily
string
versions
オプション
バージョン番号は、1.1.0、1.1.3のように分割されます.
string
#       Group  
def group_list(appkey, page, per_page, start_date, end_date, period_type, auth_token):
    url = 'http://api.umeng.com/events/group_list?appkey=%s&page=%s&per_page=%s&start_date=%s&end_date=%s&period_type=%s&auth_token=%s'%(appkey,page,per_page,start_date,end_date,period_type,auth_token)
    response = requests.get(url)
    return response.json()

カスタムイベントリストの取得
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
start_date
必須
開始日、2013-01-23
string
end_date
必須
終了日、2013-02-03
string
period_type
必須
daily/weekly/monthly、デフォルトはdaily
string
group_id
必須
グループからリストから取得したgroup_id
string
#         
def events_list(appkey, start_date, end_date, period_type, group_id, auth_token):
    url = 'http://api.umeng.com/events/group_list?appkey=%s&start_date=%s&end_date=%s&period_type=%s&group_id=%s&auth_token=%s'%(appkey, start_date, end_date, period_type, group_id, auth_token)
    response = requests.get(url)
    return response.json()

イベント・メッセージの取得/独立したユーザー数
パラメータ名
必要かどうか
パラメータの説明
タイプと範囲
appkey
必須
APP ID
string
start_date
必須
開始日、2013-01-23
string
end_date
必須
終了日、2013-02-03
string
period_type
必須
daily/weekly/monthly、デフォルトはdaily
string
group_id
必須
グループからリストから取得したgroup_id
string
type
必須
count/device、デフォルトcount
string
#       /     
def events(appkey,group_id,type,start_date,end_date,auth_token):
    url = 'http://api.umeng.com/events/daily_data?appkey=%s&group_id=%s&type=%s&start_date=%s&end_date=%s&auth_token=%s'%(appkey,group_id,type,start_date,end_date,auth_token)
    response = requests.get(url)
    return response.json()

取得パラメータリスト/取得パラメータメッセージ数
カスタムイベントに構成パラメータがある場合、カスタムイベントのクリックデータを取得します.以下のようにします.
#      
def parameter_list(appkey,event_id,type,start_date,end_date,auth_token):
    url = 'http://api.umeng.com/events/parameter_list?appkey=%s&event_id=%s&type=%s&start_date=%s&end_date=%s&auth_token=%s'%(appkey,event_id,type,start_date,end_date,auth_token)
    response = requests.get(url)
    return response.json()


#       
def parameter_data(appkey,event_id,start_date,end_date,auth_token):
    url = 'http://api.umeng.com/events/parameter_data?appkey=%s&event_id=%s&label=navigate&start_date=%s&end_date=%s&auth_token=%s'%(appkey,event_id,start_date,end_date,auth_token)
    response = requests.get(url)
    return response.json()

やれやれ、おなかがすいた.ご飯を食べに行った.