File: next-steps.rst

package info (click to toggle)
python-telethon 1.41.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,520 kB
  • sloc: python: 16,271; javascript: 200; makefile: 16; sh: 11
file content (46 lines) | stat: -rw-r--r-- 2,126 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
==========
Next Steps
==========

These basic first steps should have gotten you started with the library.

By now, you should know how to call friendly methods and how to work with
the returned objects, how things work inside event handlers, etc.

Next, we will see a quick reference summary of *all* the methods and
properties that you will need when using the library. If you follow
the links there, you will expand the documentation for the method
and property, with more examples on how to use them.

Therefore, **you can find an example on every method** of the client
to learn how to use it, as well as a description of all the arguments.

After that, we will go in-depth with some other important concepts
that are worth learning and understanding.

From now on, you can keep pressing the "Next" button if you want,
or use the menu on the left, since some pages are quite lengthy.

A note on developing applications
=================================

If you're using the library to make an actual application (and not just
automate things), you should make sure to `comply with the ToS`__:

    […] when logging in as an existing user, apps are supposed to call
    [:tl:`GetTermsOfServiceUpdate`] to check for any updates to the Terms of
    Service; this call should be repeated after ``expires`` seconds have
    elapsed. If an update to the Terms Of Service is available, clients are
    supposed to show a consent popup; if accepted, clients should call
    [:tl:`AcceptTermsOfService`], providing the ``termsOfService id`` JSON
    object; in case of denial, clients are to delete the account using
    [:tl:`DeleteAccount`], providing Decline ToS update as deletion reason.

.. __: https://core.telegram.org/api/config#terms-of-service

However, if you use the library to automate or enhance your Telegram
experience, it's very likely that you are using other applications doing this
check for you (so you wouldn't run the risk of violating the ToS).

The library itself will not automatically perform this check or accept the ToS
because it should require user action (the only exception is during sign-up).