search

Описание

пример

d = search(c,tweetquery) ищет твиты для этого термина tweetquery.

пример

d = search(c,tweetquery,parameters) просматривает твиты с использованием параметров запроса веб-сервиса. Твиттер® REST API задает параметры запроса веб-сервиса. Для допустимых параметров смотрите Поиск GET/твиты.

пример

d = search(c,tweetquery,QueryName1,QueryValue1,...,QueryNameN,QueryValueN) задает веб-сервис параметры запроса как одну или несколько пар аргументов имя-значение.

Примеры

свернуть все

Используйте объект подключения Twitter для поиска Tweets.

Создайте подключение к Twitter с помощью учетных данных. (Значения в этом примере не представляют действительные учетные данные Twitter.)

consumerkey = 'abcdefghijklmnop123456789';
consumersecret = 'qrstuvwxyz123456789';
accesstoken = '123456789abcdefghijklmnop';
accesstokensecret = '123456789qrstuvwxyz';

c = twitter(consumerkey,consumersecret,accesstoken,accesstokensecret);

Проверьте подключение к Twitter. Если на StatusCode свойство имеет значение OK, подключение успешно.

c.StatusCode
ans = 

    OK

Поиск твитов с помощью объекта подключения Twitter и термина поиска MathWorks.

tweetquery = 'MathWorks';
d = search(c,tweetquery)
d = 

  ResponseMessage with properties:

    StatusLine: 'HTTP/1.1 200 OK'
    StatusCode: OK
        Header: [1×25 matlab.net.http.HeaderField]
          Body: [1×1 matlab.net.http.MessageBody]
     Completed: 0

d является matlab.net.http.ResponseMessage объект. The StatusCode свойство показывает OK, что указывает на успешный запрос.

Доступ к MathWorks® Твиты. Отобразите 12-й твит.

 d.Body.Data.statuses{12}.text
ans =

    'MATLAB Control Systems Examples https://t.co/g2P86srv33'

Вы можете искать другие Tweets, используя search функция. Чтобы извлечь другие данные Twitter, используйте getdata функция.

Используйте объект подключения Twitter для поиска 20 твитов. Задайте количество сдвигов для извлечения в качестве структуры.

Создайте подключение к Twitter с помощью учетных данных. (Значения в этом примере не представляют действительные учетные данные Twitter.)

consumerkey = 'abcdefghijklmnop123456789';
consumersecret = 'qrstuvwxyz123456789';
accesstoken = '123456789abcdefghijklmnop';
accesstokensecret = '123456789qrstuvwxyz';

c = twitter(consumerkey,consumersecret,accesstoken,accesstokensecret);

Проверьте подключение к Twitter. Если на StatusCode свойство имеет значение OK, подключение успешно.

c.StatusCode
ans = 

    OK

Задайте поисковый термин MathWorks в переменной tweetquery. Задайте 20 твитов как поле в структуре parameters. Поиск 20 твитов с помощью объекта подключения Twitter, поисковый термин tweetquery, и структурные parameters.

tweetquery = 'MathWorks';
parameters.count = 20;
d = search(c,tweetquery,parameters)
d = 

  ResponseMessage with properties:

    StatusLine: 'HTTP/1.1 200 OK'
    StatusCode: OK
        Header: [1×25 matlab.net.http.HeaderField]
          Body: [1×1 matlab.net.http.MessageBody]
     Completed: 0

d является matlab.net.http.ResponseMessage объект. The StatusCode свойство показывает OK, что указывает на успешный запрос.

Доступ к MathWorks Tweets. Отобразите структуру Data.

d.Body.Data
ans = 

  struct with fields:

           statuses: {20×1 cell}
    search_metadata: [1×1 struct]

Структура Data содержит поле statuses. Это поле является массивом ячеек структур. Каждая структура в массиве ячеек содержит информацию об одном Tweet®.

Доступ ко всем 20 Tweet.

d.Body.Data.statuses{:}
ans = 

  struct with fields:

                   created_at: 'Fri Apr 28 17:51:55 +0000 2017'
                           id: 1.2345e+17
                       id_str: '123456789101112131'
                         text: 'This collection of over 400 MATLAB examples can help you with #controlsystems, Kalman filters, and more https://t.co/FWndxKLA6l…'
                    truncated: 0
                     entities: [1×1 struct]
                     metadata: [1×1 struct]
                       source: 'Twitter for iPhone'
        in_reply_to_status_id: []
    in_reply_to_status_id_str: []
          in_reply_to_user_id: []
      in_reply_to_user_id_str: []
      in_reply_to_screen_name: []
                         user: [1×1 struct]
                          geo: []
                  coordinates: []
                        place: []
                 contributors: []
             retweeted_status: [1×1 struct]
              is_quote_status: 0
                retweet_count: 34
               favorite_count: 0
                    favorited: 0
                    retweeted: 0
           possibly_sensitive: 0
                         lang: 'en'
...

Полевые text в каждой структуре содержится текст одного Tweet.

(Эти значения не представляют реальные данные Twitter.)

Вы можете искать другие Tweets, используя search функция. Чтобы извлечь другие данные Twitter, используйте getdata функция.

Используйте объект подключения Twitter для поиска 20 твитов. Задайте количество твитов, которые нужно получить в качестве аргумента имя-значение.

Создайте подключение к Twitter с помощью учетных данных. (Значения в этом примере не представляют действительные учетные данные Twitter.)

consumerkey = 'abcdefghijklmnop123456789';
consumersecret = 'qrstuvwxyz123456789';
accesstoken = '123456789abcdefghijklmnop';
accesstokensecret = '123456789qrstuvwxyz';

c = twitter(consumerkey,consumersecret,accesstoken,accesstokensecret);

Проверьте подключение к Twitter. Если на StatusCode свойство имеет значение OK, подключение успешно.

c.StatusCode
ans = 

    OK

Поиск 20 твитов с помощью объекта подключения Twitter, поисковый термин MathWorks, и аргумент имя-значение count.

tweetquery = 'MathWorks';
d = search(c,tweetquery,'count',20)
d = 

  ResponseMessage with properties:

    StatusLine: 'HTTP/1.1 200 OK'
    StatusCode: OK
        Header: [1×25 matlab.net.http.HeaderField]
          Body: [1×1 matlab.net.http.MessageBody]
     Completed: 0

d является matlab.net.http.ResponseMessage объект. The StatusCode свойство показывает OK, что указывает на успешный запрос.

Доступ к MathWorks Tweets. Отобразите структуру Data.

 d.Body.Data
ans = 

  struct with fields:

           statuses: {20×1 cell}
    search_metadata: [1×1 struct]

Структура Data содержит поле statuses. Это поле является массивом ячеек структур. Каждая структура массива ячеек содержит информацию об одном Tweet.

Доступ ко всем 20 Tweet.

d.Body.Data.statuses{:}
ans = 

  struct with fields:

                   created_at: 'Fri Apr 28 17:51:55 +0000 2017'
                           id: 1.2345e+17
                       id_str: '123456789101112131'
                         text: 'This collection of over 400 MATLAB examples can help you with #controlsystems, Kalman filters, and more https://t.co/FWndxKLA6l…'
                    truncated: 0
                     entities: [1×1 struct]
                     metadata: [1×1 struct]
                       source: 'Twitter for iPhone'
        in_reply_to_status_id: []
    in_reply_to_status_id_str: []
          in_reply_to_user_id: []
      in_reply_to_user_id_str: []
      in_reply_to_screen_name: []
                         user: [1×1 struct]
                          geo: []
                  coordinates: []
                        place: []
                 contributors: []
             retweeted_status: [1×1 struct]
              is_quote_status: 0
                retweet_count: 34
               favorite_count: 0
                    favorited: 0
                    retweeted: 0
           possibly_sensitive: 0
                         lang: 'en'
...

Полевые text в каждой структуре содержится текст одного Tweet.

(Эти значения не представляют реальные данные Twitter.)

Вы можете искать другие Tweets, используя search функция. Чтобы извлечь другие данные Twitter, используйте getdata функция.

Входные параметры

свернуть все

Twitter-соединение, заданное как twitter объект.

Поисковый термин Tweet, заданный как вектор символов или строковый скаляр.

Пример: "MathWorks"

Типы данных: char | string

Параметры запроса веб-сервиса, заданные как структура. Каждый параметр задается как поле в структуре. Установите в поле определенное значение в структуре. Для примера укажите количество извлекаемых твитов:

parameters.count = 20;

Twitter REST API задает параметры запроса веб-сервиса, которые он принимает как часть HTTP-запроса. Для допустимых параметров смотрите Поиск GET/твиты.

Типы данных: struct

Веб-сервис параметры запроса, заданные как одна или несколько пар аргументов имя-значение. A QueryName аргумент является вектором символов или строковым скаляром, который задает имя параметра запроса. A QueryValue аргумент является вектором символов или строковым скаляром, который задает значение параметра запроса.

Twitter REST API задает параметры запроса веб-сервиса, которые он принимает как часть HTTP-запроса. Для допустимых параметров смотрите Поиск GET/твиты.

Пример: 'count',20 извлекает 20 Tweets.

Типы данных: char | string

Выходные аргументы

свернуть все

Данные Twitter, возвращенные как matlab.net.http.ResponseMessage объект.

Чтобы извлечь данные Twitter, доступ к свойствам в d, для примера:

data = d.Body.Data
data = 
    
      struct with fields:
    
               statuses: {50×1 cell}
        search_metadata: [1×1 struct]

Продолжите доступ к вложенной структуре data для извлечения данных Twitter. Для доступа к вложенным структурам смотрите Доступ к данным во вложенных структурах.

Ограничения

  • Twitter REST API GET search/tweets конечная точка задает, что можно извлекать до 100 твитов за раз.

  • Twitter REST API GET search/tweets endpoint указывает, что вы можете получить до 7 дней исторических Tweets.

Введенный в R2017b
Для просмотра документации необходимо авторизоваться на сайте