Add docs for :priced_only flag for availabilities endpoint

[Azdaroth]

This flag is supposed to mark days for which the rates are not defined as unavailable.