API Facebook: недокументированный атрибут 'properties' для типа сообщения

Question

Официальные документы API слишком скудны ( здесь ).Там есть хотя бы один атрибут, которого нет в списке, который вы можете использовать очень полезно при создании сообщений.Это вопрос с самостоятельным ответом для документирования поля «свойства», потому что я не смог найти всю информацию о SO.

Answer 1

Поле 'свойства' устанавливается путем отправки в виде текста сериализованного объекта JSON, содержащего все свойства, которые вы хотите перечислить в нижней части вашего сообщения:

{
 "name of prop 1" : {"text": "Value of prop 1", "href":"http://..."}, 
 "name of prop 2" : "value of prop 2"
}

Сообщение будет отформатировано следующим образом:

......
.    .  User name
.Pict.
.    .  <message field>
......
        | <name> (linked to <link>)
        | <caption>
        |
        | <description>
        |
        | <name of prop 1>: <value> (linked to its link)
        | <etc>
       [*] Yesterday by <your app>

Обратите внимание также на этот вопрос , что вы можете подавить появление изображения, переопределив поле изображения полем источника; поле изображения не может быть установлено для недопустимой ссылки, но тогда поле источника может.

Наконец, поле свойств возвращается при запросе Graph API в другом формате, отличном от того, в котором оно было отправлено в:

[{
   "name": "Source",
   "text": "Title of site",
   "href": "http://www...."
},
{
   "name": "Published",
   "text": "Thursday 12th"
}]