The BBC has removed a controversial BBC documentary which prominently featured the son of a Hamas official.