Дизайн API для службы списков пользователей Google Adwords
Я пытаюсь найти лучший способ создать оболочку RESTful API вокруг API AdWords. Служба списка пользователей Adwords принимает два операнда Add
или же Remove
наряду с другими параметрами (такими как идентификатор учетной записи, идентификатор списка, контактная информация, такая как хешированные электронные письма и т. д.).
Полезная нагрузка и ответы для добавления или удаления контактов из списка пользователей по существу идентичны (за исключением операндов, упомянутых ранее - конечно, ответ не указывает, какой метод вы отправили, что является особенно плохим).
Мой вопрос, какой глагол действия я должен использовать для Add
а также Remove
методы, в моей обертке? POST
кажется наиболее подходящим для Add
и пока я учел DELETE
за Remove
, он не совсем подходит, так как я не удаляю ресурс (ресурс будет списком пользователей), я просто изменяю его.
Должен ли я использовать PUT
вместо? Или глагол не имеет значения, поскольку фактическое обновление / изменение списка пользователей обрабатывается самим API AdWords?