Counter-terror police are investigating whether a controversial BBC documentary about Gaza broke the law.