معرفی شرکت ها
addthis-0.1.2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A Python wrapper for the AddThis Analytics API
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | addthis-0.1.2 |
| نام | addthis |
| نسخه کتابخانه | 0.1.2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Alex Parinov |
| ایمیل نویسنده | creafz@gmail.com |
| آدرس صفحه اصلی | https://github.com/creafz/python-addthis |
| آدرس اینترنتی | https://pypi.org/project/addthis/ |
| مجوز | MIT License |
==============
python-addthis
==============
.. image:: https://pypip.in/version/addthis/badge.svg
:target: https://pypi.python.org/pypi/addthis/
:alt: Latest Version
.. image:: https://travis-ci.org/creafz/python-addthis.svg?branch=master
:target: https://travis-ci.org/creafz/python-addthis
.. image:: https://coveralls.io/repos/creafz/python-addthis/badge.png?branch=master
:target: https://coveralls.io/r/creafz/python-addthis?branch=master
A Python wrapper for the `AddThis Analytics API <http://support.addthis.com/customer/portal/articles/381264-addthis-analytics-api/>`_.
Requirements
------------
* Python 2.6, 2.7 or 3.2+
* `python-requests <https://pypi.python.org/pypi/requests/>`_ library
Installation
------------
Install from PyPI::
pip install addthis
Usage
-----
::
from addthis import Addthis
# create an AddThis instance using userid and password from your AddThis account and optionally provide a pubid
addthis = Addthis(userid="YOUR_USER_ID", password="YOUR_PASSWORD", pubid="YOUR_PUB_ID")
# get the number of shares for the last day
print addthis.shares.day()
# get the number of shares by day for the last week
print addthis.shares.day(period="week")
You can see a full description of all supported metrics and dimensions at http://support.addthis.com/customer/portal/articles/381264-addthis-analytics-api
A few more examples
~~~~~~~~~~~~~~~~~~~
**How many times was my content shared on Twitter, by day, over the last week?**
::
>>> addthis.shares.day(period="week", service="twitter")
**What were my top shared urls for the pubid="MY_PUB_ID"?**
::
>>> addthis.shares.url(pubid="MY_PUB_ID")
**How many users shared my content this month, broken down by their interests?**
::
>>> addthis.sharers.interest(period="month")
**Which sharing services sent the most clicks back to my site this week?**
::
>>> addthis.clicks.service(period="week")
Exceptions
----------
AddthisValidationError
~~~~~~~~~~~~~~~~~~~~~~
Addthis object expects to be called with 2 parameters - "metric" and "dimension"::
addthis.<metric>.<dimension>()
For example::
>>> addthis.shares.day() # "shares" is a metric and "day" is a dimension
If it gets another number of parameters (e.g. addthis.shares() or addthis.shares.day.week()) it will raise an **AddthisValidationError**.
::
from addthis import Addthis, AddthisValidationError
addthis = Addthis(userid="YOUR_USER_ID", password="YOUR_PASSWORD", pubid="YOUR_PUB_ID")
try:
addthis.shares()
except AddthisValidationError as e:
print e # "Incorrect number of parameters are given. Expected 2 but got 1."
AddthisError
~~~~~~~~~~~~
**AddthisError** is raised when AddThis service returns a response with a HTTP status code other than 200. The exception object has 4 attributes:
* *status_code*: Code from the HTTP response.
* *code*, *message*, *attachment*: Error attributes from the AddThis response body. (see the “Error" section in the `AddThis Analytics API documentation <http://support.addthis.com/customer/portal/articles/381264-addthis-analytics-api/>`_ for more information).
::
from addthis import Addthis, AddthisError
addthis = Addthis(userid="INCORRECT_USER_ID", password="INCORRECT_PASSWORD", pubid="INCORRECT_PUB_ID")
try:
addthis.shares.day()
except AddthisError as e:
print e # "401 Error (code = '80', message='authentication failed', attachment='{u'nonce': None, u'realm': u'AddThis', u'opaque': None})'."
print e.status_code # 401
print e.code # 80
print e.message # "authentication failed"
print e.attachment # {u'nonce': None, u'realm': u'AddThis', u'opaque': None}
نحوه نصب
نصب پکیج whl addthis-0.1.2:
pip install addthis-0.1.2.whl
نصب پکیج tar.gz addthis-0.1.2:
pip install addthis-0.1.2.tar.gz