使用Python脚本添加Gmail过滤器时遇错误求助

核心错误原因 #

你遇到的HttpError 400: Filter doesn't have any actions是因为过滤器请求体的字段拼写错误：
你写的removeLabelsIds多了一个s，Gmail API要求的正确字段名是removeLabelIds。API无法识别错误的字段名，因此判定过滤器没有配置任何动作。

另外，直接访问API链接返回401属于正常情况——手动访问时没有携带OAuth2认证令牌，和代码里的认证逻辑无关，你的代码认证环节是正常的（能列出标签、过滤器就是证明）。

修正后的核心代码 #

import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

def main():
    scope = ['https://www.googleapis.com/auth/gmail.settings.basic']
    credentials_file = 'credentials.json'
    token_file = f'token_test.json'

    credentials = None
    if os.path.exists(token_file):
        credentials = Credentials.from_authorized_user_file(token_file, scope)
    if not credentials or not credentials.valid:
        if credentials and credentials.expired and credentials.refresh_token:
            credentials.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(credentials_file, scope)
            credentials = flow.run_local_server(port=0)
        with open(token_file, 'w') as token:
            token.write(credentials.to_json())

    service = build('gmail', 'v1', credentials=credentials)
    # 修正字段拼写：removeLabelsIds → removeLabelIds
    filter_body = {'criteria': {'from': 'example@example.com'}, 'action': {'removeLabelIds': ['SPAM']}}
    result = (
        service.users()
        .settings()
        .filters()
        .create(userId='me', body=filter_body)
        .execute())

    return result

if __name__ == '__main__':
    main()

额外验证提示 #

如果需要添加更多动作（比如添加标签），可以按照API规范扩展filter_body，例如：

filter_body = {
    'criteria': {'from': 'example@example.com'},
    'action': {
        'removeLabelIds': ['SPAM'],
        'addLabelIds': ['INBOX', 'STARRED']  # 添加收件箱、星标标签
    }
}

内容的提问来源于stack exchange，提问作者Jan Pips