Цей посібник є керівництвом для SEO-фахівців по використанню Google Indexing API. Мета цього посібника — використовувати скрипт на Python для масового надсилання URL-адрес до Google для сканування, щоб виправити деякі проблеми з індексацією ваших сторінок, пов’язані з індексованими URL-адресами, які скануються, але наразі не індексуються. Дотримуйтесь покрокової інструкції, проілюстрованої зображеннями, щоб використовувати Google Indexing API за допомогою Python.
Крок 1: Встановлення Python
Для роботи з Pyton скриптами потрібно, щоб на вашому комп’ютері (ноутбуці) був встановлений Python. Якщо ви його вже маєте, можете пропустити цей крок. Для тих у кого немає, вам необхідно зайти на офіційний сайт www.python.org завантажити та встановити останню версію Python.
Я використовую Mac, якщо ви використовуєте Windows кроки будуть ідентичні.
Крок 2: Налаштування ключа API індексації в Google Developer Console
Перейдіть до Google Developer Console. Google Indexing API є безкоштовним. Тому не турбуйтеся про додавання білінгового акаунта, якщо ви просто використовуєте API індексації.
Створіть новий проект. Дайте йому назву, яка буде зручною і зрозумілою, я назву проект “SEOBLOG”. Натисніть кнопку “Створити”.
Перейдіть до новоствореного проєкту (проєкт SEOBLOG). Після створення нового проєкту збережіть його як вибраний проєкт, як показано на скріншоті нижче, і виконайте наступні кроки.
Налаштування облікових даних API та сервісів. Для цього вам потрібно налаштувати облікові дані API, перейшовши за посиланням “Облікові дані” в меню “API та сервіси” на лівій бічній панелі. Опинившись у вікні “Credentials”, натисніть на “Manage Service Accounts” і створіть новий обліковий запис служби.
Створіть обліковий запис сервісу. На екрані Створення облікового запису сервісу ви можете виконати кроки, показані на екрані, щоб налаштувати свій новий обліковий запис сервісу.
Назвіть обліковий запис ім’ям, що запам’ятовується і пов’язане з вашим проектом. Я використовую назву “SEOBLOG Indexing Service Account”.
Після того, як ви додасте ім’я і натиснете на кнопку “Створити та продовжити”, вам потрібно буде вибрати роль, яка надасть вашому обліковому запису доступ до проекту.
Виберіть роль “Власник” та натисніть кнопку “Готово”.
Після того, як ви виконаєте цей крок, ви потрапите на сторінку “Облікові записи сервісів для проекту”, як показано на скріншоті нижче. Ви побачите адресу електронної пошти (gservicesaccount.com), пов’язану з вашим проектом і обліковим записом служби.
Скопіюйте цю адресу електронної пошти, оскільки ви будете використовувати її на наступному етапі в Кроці 3.
Створіть ключ для свого облікового запису. Натисніть на три крапки під колонкою дій і виберіть опцію “Керування ключами”.
Ви потрапите на сторінку “Ключі”, де зможете додати ключ, натиснувши на кнопку “Додати ключ”. Залиште опцію JSON і натисніть кнопку “Створити”. Буде завантажено невеликий JSON-файл. Це файл аутентифікації, який буде перевіряти ваш доступ до API. З’явиться вікно з написом “Приватний ключ збережено на вашому комп’ютері”.
Вмикаємо API. Наступним кроком буде увімкнення API. Для цього потрібно перейти в розділ “APIs & Sevices” на вибрати опцію “Library”.
Знайдіть “indexing api” і виберіть перший варіант Web Search Indexing API з двох запропонованих.
Натисніть кнопку “Увімкнути”, на наступному екрані.
На цьому ми завершуємо кроки розділу з налаштування API індексування в Google Developer Console.
Крок 3: Надання доступу власнику до електронної пошти GServicesAccount в Google Developer Console
На цьому кроці ви надасте доступ на рівні власника до адреси електронної пошти gservicesaccount.com, створеної на попередньому кроці. Якщо ви не зберегли адресу електронної пошти на попередньому кроці, ви можете переглянути її, вибравши посилання Облікові дані на лівій бічній панелі.
Після того, як ви скопіювали адресу електронної пошти, перейдіть до свого облікового запису Google Search Console:
- Відкрийте ваш проєкт у Google Search Console.
- Перейдіть у “Settings”.
- Увійдіть у розділ “Users and permissions”.
- Натисніть на кнопку “Add User”.
- Додайте сервісну електронну пошту.
- Виберіть статус “Owner” і натисніть на кнопку “Add”.
Крок 4: Запуск скрипта Python
На попередніх кроках ми завершили налаштування ключа API індексування в Google Developer Console, встановили Python та надали доступ власника до ключа API в Google Search Console. Тепер ми перейшли до останнього кроку, на якому ми будемо використовувати Google indexing API за допомогою скрипта на Python.
Встановлення бібліотек
Відкрийте термінал на Mac (або командний рядок якщо у Windows). Нам потрібно буде встановити деякі бібліотеки, перш ніж ми зможемо використовувати Google Indexing API. Запустіть наступні дві команди у терміналі:
Для користувачів Mac:
Команда 1: pip3 install oauth2client httplib2
Команда 2: pip3 install pandas
Для користувачів Windows:
Команда 1: pip install oauth2client httplib2
Команда 2: pip install pandas
Необхідні файли
Створіть папку, в яку помістіть 3 файли:
- Python Script;
- URLs.csv;
- JSON-файл (який ви завантажили раніше).
Файл JSON, завантажений на кроці 2, потрібно буде перемістити в цю папку. Завантажте файл urls.csv, який міститиме список URL-адрес, які ви хочете відправити для індексації в Google, і код indexing.py за цим посиланням і перемістіть їх в одну папку, як показано на скріншоті нижче.
Або самостійно створити та додати скопіювати скрипт Python з github.com.
Оновлюємо код Python та CSV-файл
Вам потрібно лише внести невелику зміну в рядок 8 python-коду indexing.py. Замініть назву JSON-файлу в цьому рядку JSON_KEY_FILE = “YOUR_JSON_FILE.json” на назву вашого JSON-файлу.
Ви можете відредагувати файл за допомогою таких програм, як Sublime Text, PyCharm, VS Code або іншими IDE.
Далі вам потрібно буде додати URL-адреси в стовпчик A файлу urls.csv. Не видаляйте перший рядок, що містить значення URL і дати. Ви можете додати максимум 100 URL-адрес за раз.
Я користуюся здебільшого Google таблицями, тому я створив файл і додав до нього потрібні мені 100 URL і скачав його у форматі CSV(.csv).
Запускаємо скрипт
Відкрийте термінал на Mac (або командний рядок якщо ви використовуєте Windows) та перейдіть до папки, що містить 3 файли. Ви можете скористатися командою change directory CD, як показано на скріншоті нижче. Опинившись у потрібній папці, ви можете запустити скрипт за допомогою наведеної нижче команди.
Для користувачів Mac:
Команда: python3 indexing.py
Для користувачів Windows:
Команда: python indexing.py
Маленька покрокова інструкція в терміналі
- Відкриваємо термінал і вводимо команду
cd Desktop(якщо у вас папка знаходиться на робочому столі). - Щоб перевірити що папка з файлами знаходиться дійсно на робочому столі, введіть команду
ls(у прикладі ми бачимо, що на робочому столі є одна папка SEOBLOG). - Щоб перейти в папку для запуску скрипта потрібно ввести команду
cd SEOBLOG(у вашому випадку потрібно ввести назву вашої папки). - Щоб перевірити що в папці в яку ми перейшли знаходяться наші файли, введіть
ls(на прикладі у файлі знаходяться потрібні нам файли) - Вводимо команду
python3 indexing.py
Після того, як ви введете команду і натиснете кнопку введення, ви побачите сповіщення про оновлення URL-адрес Google для всіх URL-адрес, які були введені у вашому файлі urls.csv, по черзі, разом з часовими мітками.
Ліміти Google Indexing API для додавання URL
Добові ліміти:
- 200 URL для запитів URL_NOTIFICATION_UPDATED і URL_NOTIFICATION_DELETED.
- 100 URL для запитів URL_NOTIFICATION_MULTI.
- 180 запитів для GET /v3/urlNotifications/metadata.
- 600 запитів у сумі для всіх методів API.
Також важливо, щоб:
- URL відповідав правилам Google Search Console.
- URL не повинен бути заблокований robots.txt.
Google може не проіндексувати всі URL, навіть якщо вони були відправлені через API.