Хромирование деталей своими руками видео: Хромирование в домашних условиях: технология, видео

Содержание

ХРОМИРОВАНИЕ ДОМА своими руками [деталей, пластика, дисков]

Любой умелец стремится самостоятельно освоить множество самых разных видов работ, а значит, ему будет интересно, [как выполнить хромирование в домашних условиях] самых разных деталей и материалов, произведенных на основе металла или пластика.

Особенно эта технология актуальна для тех, кто имеет свой собственный автомобиль и хочет, чтобы он всегда имел привлекательный внешний вид.

Если самостоятельно освоить процесс хромирования, то можно будет сэкономить значительную сумму денег и обойтись без посещения автосервиса.

1 – стеклянная емкость (банка), 2 – анод (или аноды), 3 – хромируемая деталь (катод), 4 – раствор электролита.

Конечно, для того чтобы выполнить хромирование в домашних условиях потребуется определенное химическое оборудование, которое также можно сделать своими руками.

В автосервисах предлагают профессиональное хромирование деталей из пластика и металла, дисков, однако стоит такое удовольствие приличную сумму денег.

Технология, по которой проводится данный процесс, достаточно простая и не требует каких-то специфических познаний.

Также при правильном подходе в домашних условиях можно провести гальваническое, а также каталитическое хромирование, кроме этого, выполнить никелирование как дисков, так и деталей из пластика.

Содержание:

  • Некоторые особенности
  • Подготовка к хромированию
  • Выполнение хромирования
  • Советы и рекомендации

Некоторые особенности

Как правило, хромированию подвергаются как пластиковые детали, так и изделия, выполненные из металла, в том числе и хромирование дисков.

Данный процесс, в том числе и каталитическое хромирование, несмотря на некоторую специфику и нюансы, сможет своими руками сделать каждый домашний умелец.

В первую очередь, перед проведением своими руками хромирования, необходимо определиться с местом проведения работы.

Видео:

Для данного процесса следует подобрать хорошо вентилируемое пространство, так как придется много работать с самыми разными химическими реагентами, воздействие которых может плохо сказаться на здоровье.

Наиболее оптимальным местом в этом случае может стать гараж либо просторная подсобка.

Хромирование при определенных условиях можно провести и на балконе в квартире, конечно, если он имеет достаточную площадь.

Также необходимо подумать и о средствах защиты. Рекомендуется для этих целей использовать фартук, защитные очки, а также респиратор и обязательно резиновые перчатки.

Следует подготовить и все необходимое оборудование и, в первую очередь, емкость.

В качестве емкости под хромирование можно использовать обычную трехлитровую банку или небольшое пластмассовое ведро.

Если детали имеют сложную конфигурацию и большие размеры, то и соответственно емкость должна быть более объемной и вместительной.

Также следует подготовить ящик из дерева, предварительно изолированный стеклотканью и утепленный песком.

Так как процесс подразумевает работу при высоких температурах, придется подумать и о нагревательном элементе.

Для этих целей можно использовать самый обыкновенный ТЭН. Под рукой следует иметь термометр, который оснащен шкалой до ста градусов по Цельсию, а также лист фанеры.

Для хромирования в домашних условиях следует приобрести специальный зажим, а также кронштейн для крепления обрабатываемых деталей.

Для проведения необходимой работы потребуется гальваническая установка, которая собирается своими руками из вышеуказанных элементов.

На видео, которое размещено ниже, подробно рассказано о том, как самостоятельно провести хромирование деталей, выполненных из пластика.

Подготовка к хромированию

Как правило, в большинстве случаев выполняется гальваническое хромирование, и для того, чтобы его провести самостоятельно, придется собрать определенное оборудование.

Для начала следует снять с плотной кисти щетину и обмотать ее свинцовым проводом.

После этого изготавливается специальная кисть, а для этого потребуется оргстекло. Готовая кисть должна иметь пустой корпус, который впоследствии можно будет заполнить электролитом.

Видео:

В качестве источника тока потребуется приобрести достаточно мощный трансформатор, к которому в особой последовательности необходимо будет подсоединить анод и катод.

Источником тока может послужить и обычный аккумулятор от автомобиля, однако в этом случае придется несколько изменить схему установки.

Далее к предварительно изготовленной кисти следует подсоединить диод. Его анод подсоединяется к кабелю, идущему от понижающей обмотки трансформатора.

В свою очередь катод будет крепиться к самой детали, которая подлежит хромированию. В том случае, если источником питания выступает аккумулятор от автомобиля, то из схемы изымается диод.

Далее готовится установка непосредственно под выполнение хромирования, и готовится раствор, в котором необходимо будет в обязательном порядке обработать каждую деталь.

Для его приготовления необходимо взять в определенных пропорциях натру, силикатный клей и кальцинированную соду. Все компоненты разбавляются в обыкновенной воде и тщательно перемешиваются.

После этого полученный состав нагревается до температуры кипения и только после этого в него помещаются заготовки.

Данный раствор помогает быстро и эффективно обезжирить пластиковую или металлическую поверхность у обрабатываемой детали.

Также детали перед началом хромирования тщательно очищаются от грязи и всевозможных окислов.

После того как будут проведены все предварительные процедуры и подготовлено все необходимое оборудование, необходимо надеть защитную спецодежду и можно приступать к выполнению работы своими руками.

Данная процедура, так же как и никелирование, требует аккуратности и строго выполнения технологии.

Выполнение хромирования

Хромирование металлических пластиковых деталей начинают с того, что их соединяют с трансформатором посредством провода.

Далее берут предварительно изготовленную кисть, также соединенную с источником питания, и заливают в нее необходимое количество электролита.

После этого на поверхность обрабатываемого материала следует аккуратно и максимально равномерно нанести слой электролита, при этом кисть следует перемещать плавными движениями вверх и вниз.

Видео:

Следует определиться со слоем наносимого покрытия и лучше сделать его достаточно толстым. Это обеспечит качественное хромирование и гарантирует то, что в ближайшее время он не слезет.

Специалисты рекомендуют проходить по одному месту кистью на поверхности обрабатываемой детали до тридцати раз.

При выполнении работ следует постоянно контролировать кисть на предмет наличия в ней электролита и при необходимости добавлять его.

Выполняемое таким образом гальваническое хромирование металлических дисков или пластиковых деталей позволит нанести качественное покрытие самостоятельно.

После того как будет закончена работа с электролитом, все обрабатываемые детали необходимо тщательно промыть в проточной воде.

Далее им дают высохнуть, после чего при помощи куска плотной материи полируют до появления качественного блеска.

Хромирование деталей и дисков считается достаточно опасной процедурой, так как работа выполняется с химически активными веществами, которые могут нанести определенный вред здоровью.

В случае попадания используемого раствора на кожные покровы, можно получить достаточно серьезный ожог.

Кроме этого, при неаккуратном использовании электролита может наступить химическое отравление организма, что также очень опасно для здоровья человека.

Всю работу следует выполнять только в защитных средствах, используя резиновые перчатки и респиратор. Следует помнить и то, что не все металлические диски и детали поддаются хромированию.

В некоторых случаях для того, чтобы нанести декоративное покрытие, приходится выполнять никелирование, предварительно покрыв заготовку тонким медным слоем.

Более подробно о том, как самостоятельно провести хромирование деталей из пластика или дисков, рассказано на видео, которое размещено ниже.

Советы и рекомендации

Очень часто придать металлической детали привлекательный внешний вид помогает никелирование, которое также может быть выполнено своими руками.

По своей сути никелирование чем-то напоминает хромирование, однако данный метод подразумевает использование не электролита, а специально приготовленный состав.

Оба метода покрытия поверхностей защитным слоем популярны у автолюбителей.

За счет хромирования различные детали приобретают свойство отражать солнечный свет, однако с течением времени данная способность постепенно утрачивается.

Чтобы избежать этого, за хромированной поверхностью следует периодически ухаживать.

Видео:

Те детали на автомобиле, которые были хромированы, следует мыть только теплой водой с добавлением специальных моющих средств.

После мойки их следует тщательно протереть тряпкой, которая не содержит ворс. Нельзя для мытья автомобиля использовать какой-либо грубый материал, который может повредить поверхность хромированных деталей.

Также следует избегать при мойке машины резких перепадов температур, так как от этого покрытие становится блеклым и теряет свой первоначальный вид.

Рекомендуется после проведения хромирования выполнить антикоррозионную защиту и тщательно отполировать всю площадь поверхности.

Хромируем деталь автомобиля самостоятельно | Портал Кузов


  • Главная
  • /

  • Автовладельцам
  • /
  • Хромируем деталь автомобиля самостоятельно

18 апреля 2021


Кто хоть однажды слышал о таком процессе, наверняка задавался вопросом для чего нужно хромировать деталь автомобиля? Этот процесс несёт в себе две функции: во-первых, это восстановление детали, а также улучшение эстетического вида и придание особого стиля автомобилю; во-вторых, защита авто от коррозии и упрощение ухода за ним, так как гладкая поверхность легко отталкивает влагу, загрязнения.


Самостоятельно хромировать далеко не просто, потому что метод основывается на обработке детали молекулами хрома способом диффузии или воздействием электричества. Поэтому большинство автолюбителей предпочитают доверить автомобиль специалистам с большим стажем работы. Однако, имея знания и оборудование, хромировать автомобильную деталь вполне возможно самому. Рассмотрим часто используемый вариант хромирования без помощи специалистов. Помимо этого, есть видеоролик на тему, как можно покрасить при специальных условиях, используя краску хрома.

Что потребуется, чтобы самостоятельно хромировать авто или деталь


Для достижения лучшего эффекта покраски своими силами, вам понадобится иметь под рукой следующие инструменты, материалы:

  1. Ёмкость такого же размера, как деталь. Она должна быть не металлической;
  2. Устройство, устойчивое к кислоте;
  3. Термометр с номиналом до 100 °C;
  4. Выпрямитель с напряжением 12 В, силой тока 50 А;
  5. Зажим — катод, стержень — анод, пластина.


Помимо этого, понадобится основной компонент — электролит, растворитель, серная и соляная кислота, свинец, дистиллят с поваренной солью. Сегодня можно заказать готовые наборы для покраски авто самим, там имеется всё необходимое. Хромировать авто или покрасить краской детали, важно в проветриваемом помещении, с применением защитной одежды, перчаток, респиратора.

Технология покрытия хромом авто


До проведения самой процедуры требуется провести следующие подготовительные и основные действия с деталями, обеспечивающие качественное восстановление полученной на выходе детали и срок дальнейшей эксплуатации:

  • предварительно отполировать, обезжирить деталь при помощи ацетона. Это позволит защитить покрытие от появления коррозии;
  • обработать деталь в соляном растворе в течение 5 -20 мин. , время зависит от того, как сильно испорчена поверхность;
  • нагреть электролит до 45-60 °C;
  • после промывают под водой;
  • применяя фиксатор, деталь опускают в электролитный раствор, на фиксатор крепится катод с выходом (-), а рядом размещают из свинца анод (+). Выдерживают до 40 мин., после промывают водой;
  • иногда деталь полируют, доводя до зеркального блеска.


Нередко возникают проблемы с хромой, исключающиеся при повышении температуры, увеличении количества хромого ангидрита, а также более тщательном обезжиривании.


Мы описали вариант восстановления методом хромирования детали дома. Существуют другие типы создания эффекта хрома, такие как оклейка автопленкой, покраска хромой (использование краски подробно показано в видео, ссылка выше указана), гальваническое хромирование.


Любое дело любит желание, время, стремление научиться чему-то новому. Попробовав процедуру восстановления детали и покрасив на деле, вы на опыте познакомитесь с особыми нюансами и следующий раз это не будет для вас столь сложным. Хромированный автомобиль всегда привлекает внимание окружающих. Выразите свою индивидуальность хромированными деталями на автомобиле.

Комментарии

Рекомендованные статьи


Spectra Chrome – усовершенствованная технология напыления Chrome

BY HGI & RIDDELL ≫

ARCHITECTURAL

LUXURY RESORT
& CASINO COMPLEX ≫ 9000 4

НОВИНКА

ГАРАНТИРОВАННО
НИКОГДА ЖЕЛТЫЙ ≫

СЕРИЯ NETFLIX

КРЕСТ
САНТО-ДОМИНГО ≫ 900 04

РЕЗКА И РАЗРЫВ ВИНИЛА ≫

КОСТЮМ ДЛЯ ПЕРСОНАЖА ≫

30-ЛЕТНЯЯ СБОРКА ≫

SUPER ADHESION 8 ≫

СПРЕЙ ХРОМ ЛЮБОГО ЦВЕТА

СПРЕЙ ХРОМ ЛЮБОГО ЦВЕТА

900 43 НА НИЧЕГО!


Компания Spectra Chrome усовершенствовала процесс напыления хрома — и мы можем это доказать! Более 10 лет исследований и разработок позволили добиться характеристик покрытия, которым доверяют самые взыскательные компании мира, в огромном диапазоне рыночных применений.

Пожалуйста, позвольте нам заработать на вашем бизнесе и показать вам, как это делается — посетите наши сертифицированные курсы обучения во Флориде или Калифорнии. Узнайте, как применять эту отделку от профессиональных тренеров, которые проведут вас через каждый шаг процесса.

Позвольте нам показать вам, почему Spectra Chrome является мировым лидером в области напыления хрома!


КАК ЭТО РАБОТАЕТ?

ШАГ 1:

БАЗОВОЕ ПОКРЫТИЕ

Детали сначала покрываются специальным белым базовым покрытием Spectra Chrome. Самовыравнивающаяся формула ложится гладко, ровно и блестит — идеальная основа для эффектного хромового покрытия.

ШАГ 2:

МЕТАЛЛИЧЕСКИЙ РАСПЫЛИТЕЛЬ

Далее наносится уникальный раствор серебра на водной основе с помощью специально разработанного пистолета-распылителя с двойным соплом. Серебряный туман ложится ровно и создает отражающую способность до идеального зеркального блеска.

ШАГ 3:

ПОКРЫТИЕ

Сверхпрочный автомобильный прозрачный лак запечатывает серебристую отделку и обеспечивает невероятную устойчивость к ультрафиолетовому излучению и непревзойденную долговечность. Это прозрачное верхнее покрытие можно тонировать в любой оттенок спектра!

Spectra Chrome доверяют самые известные компании мира. Наша отделка является синонимом бескомпромиссного качества и непревзойденной долговечности – список наших известных клиентов говорит сам за себя! Взгляните, что отличает Spectra Chrome:

ЛУЧШИЙ В ПРОМЫШЛЕННОСТИ

ОБОРУДОВАНИЕ И ПРИНАДЛЕЖНОСТИ

Наши запатентованные системы хромирования с напылением, разработанные и изготовленные вручную с использованием компонентов высочайшего качества, являются отраслевым стандартом. Мы предлагаем полный спектр систем; позволяя нашим клиентам воспользоваться преимуществами любого рынка.

Мы также разработали ряд полезных аксессуаров, специально созданных для процесса Spectra Chrome; чтобы помочь нашим клиентам максимально повысить эффективность процесса напыления хрома.

Подробнее ≫


ИННОВАЦИОННАЯ ХИМИЯ:

НЕПРЕВЗОЙДЕННАЯ ЭФФЕКТИВНОСТЬ

Наша запатентованная химия обеспечивает безупречное покрытие, рассчитанное на долгий срок службы! Spectra Chrome так же долговечен, как автомобильная отделка OEM — он будет держаться так же, как краска на вашем автомобиле. И что самое удивительное, Spectra Chrome — единственный существующий хромированный продукт, в котором остается полностью гибким, как , на виниле и полипропилене.

Проверенные составы верхнего покрытия, устойчивые к ультрафиолетовому излучению, означают, что Spectra Chrome никогда не пожелтеет и не выцветет на солнце, а удивительная адгезия внутри слоя предотвращает скалывание, отслаивание или отслаивание. Мы прошли все тесты, какие только могли придумать, и результаты говорят сами за себя!

Подробнее ≫


МИРОВОЙ КЛАСС

ПОДДЕРЖКА И ИНСТРУКЦИЯ

Мы гордимся качеством нашей поддержки клиентов. До, во время и особенно после продажи; мы здесь, чтобы помочь вам добиться успеха! Приезжайте во Флориду и посетите практический курс обучения, проводимый нашими опытными инструкторами, которые каждый день распыляют Spectra Chrome.

Если вы не можете отправиться в путешествие, мы предлагаем наш потрясающий, всеобъемлющий онлайн-тренинг . И если вы хотите персонализированное обучение один на один в вашем собственном магазине; наши мастера-тренеры могут даже отправиться в любую точку мира, чтобы приехать к вам .

Подробнее ≫


Часто задаваемые вопросы

Ознакомьтесь с нашими часто задаваемыми вопросами, чтобы узнать все о процессе Spectra Chrome!

Часто задаваемые вопросы о Spectra Chrome ≫

Есть вопросы?

Свяжитесь с нами сегодня – наши дружелюбные представители будут рады помочь!

Свяжитесь с нами ≫

Варианты финансирования

Мы поможем вам получить необходимое оборудование с вариантами финансирования для любого бюджета.

Информация о финансировании ≫

Обзор API данных YouTube | Google для разработчиков

Введение

Этот документ предназначен для разработчиков, которые хотят писать приложения, взаимодействующие с YouTube. В нем объясняются основные понятия YouTube и самого API. Он также предоставляет обзор различных функций, поддерживаемых API.

Перед началом работы

  1. Вам нужна учетная запись Google, чтобы получить доступ к консоли Google API, запросить ключ API и зарегистрировать свое приложение.

  2. Создайте проект в Google Developers Console и получите учетные данные авторизации, чтобы ваше приложение могло отправлять запросы API.

  3. После создания проекта убедитесь, что YouTube Data API является одной из служб, для использования которых зарегистрировано ваше приложение:

    1. Перейдите в консоль API и выберите проект, который вы только что зарегистрировали.
    2. Посетите страницу «Включенные API».

      В списке API убедитесь, что статус ON для API данных YouTube v3 .

  4. Если ваше приложение будет использовать какие-либо методы API, требующие авторизации пользователя, прочтите руководство по аутентификации, чтобы узнать, как реализовать авторизацию OAuth 2.0.

  5. Выберите клиентскую библиотеку, чтобы упростить реализацию API.

  6. Ознакомьтесь с основными понятиями формата данных JSON (нотация объектов JavaScript). JSON — это распространенный независимый от языка формат данных, обеспечивающий простое текстовое представление произвольных структур данных. Для получения дополнительной информации см. json.org.

Ресурсы и типы ресурсов

Ресурс — это отдельный объект данных с уникальным идентификатором. В таблице ниже описаны различные типы ресурсов, с которыми можно взаимодействовать с помощью API.

Ресурсы
деятельность Содержит информацию о действии, которое определенный пользователь предпринял на сайте YouTube. Действия пользователя, о которых сообщается в каналах активности, включают, среди прочего, оценку видео, совместное использование видео, отметку видео как избранного и публикацию бюллетеня канала.
канал Содержит информацию об одном канале YouTube.
Баннер канала Определяет URL-адрес, используемый для установки недавно загруженного изображения в качестве изображения баннера для канала.
каналСекция Содержит информацию о наборе видео, которые канал выбрал для показа. Например, в разделе могут быть представлены последние загрузки канала, самые популярные загрузки или видео из одного или нескольких плейлистов.
направляющаяКатегория Определяет категорию, которую YouTube связывает с каналами на основе их содержания или других показателей, таких как популярность. Категории направляющих предназначены для организации каналов таким образом, чтобы пользователям YouTube было проще находить нужный им контент. Хотя каналы могут быть связаны с одной или несколькими категориями справочника, их принадлежность к какой-либо категории справочника не гарантируется.
i18nLanguage Указывает язык приложения, поддерживаемый веб-сайтом YouTube. Язык приложения также можно назвать языком пользовательского интерфейса.
i18nRegion Определяет географическую область, которую пользователь YouTube может выбрать в качестве предпочтительного региона контента. Область контента также может называться локалью контента.
плейлист Представляет один плейлист YouTube. Плейлист — это набор видео, которые можно просматривать последовательно и делиться ими с другими пользователями.
плейлистЭлемент Идентифицирует ресурс, например видео, являющееся частью списка воспроизведения. Ресурс playlistItem также содержит сведения, объясняющие, как включенный ресурс используется в списке воспроизведения.
результат поиска Содержит информацию о видео, канале или списке воспроизведения YouTube, которые соответствуют параметрам поиска, указанным в запросе API. Хотя результат поиска указывает на уникально идентифицируемый ресурс, такой как видео, у него нет собственных постоянных данных.
подписка Содержит информацию о подписке пользователя YouTube. Подписка уведомляет пользователя, когда на канал добавляются новые видео или когда другой пользователь выполняет одно из нескольких действий на YouTube, например загружает видео, оценивает видео или комментирует видео.
эскиз Идентифицирует уменьшенные изображения, связанные с ресурсом.
видео Представляет одно видео YouTube.
видеоКатегория Указывает категорию, которая была или может быть связана с загруженными видео.
водяной знак Идентифицирует изображение, которое отображается во время воспроизведения видео определенного канала. Владелец канала также может указать целевой канал, на который ссылается изображение, а также сведения о времени, которые определяют, когда водяной знак появляется во время воспроизведения видео, а затем продолжительность его видимости.

Обратите внимание, что во многих случаях ресурс содержит ссылки на другие ресурсы. Например, свойство snippet.resourceId.videoId ресурса playlistItem идентифицирует видеоресурс, который, в свою очередь, содержит полную информацию о видео. В качестве другого примера, результат поиска содержит свойство videoId , playlistId или channelId , которое идентифицирует конкретное видео, список воспроизведения или ресурс канала.

Поддерживаемые операции

В следующей таблице показаны наиболее распространенные методы, поддерживаемые API. Некоторые ресурсы также поддерживают другие методы, выполняющие функции, более специфичные для этих ресурсов. Например, метод videos.rate связывает пользовательский рейтинг с видео, а метод thumbnails. set загружает эскиз видео на YouTube и связывает его с видео.

Операции
список Извлекает ( GET ) список из нуля или более ресурсов.
вставка Создает ( POST ) новый ресурс.
обновление Изменяет ( PUT ) существующий ресурс для отражения данных в вашем запросе.
удалить Удаляет ( DELETE ) определенный ресурс.

API в настоящее время поддерживает методы для перечисления каждого из поддерживаемых типов ресурсов, а также поддерживает операции записи для многих ресурсов.

В таблице ниже указаны операции, которые поддерживаются для различных типов ресурсов. Операции, которые вставляют, обновляют или удаляют ресурсы, всегда требуют авторизации пользователя. В некоторых случаях методы списка поддерживают как авторизованные, так и неавторизованные запросы, где неавторизованные запросы извлекают только общедоступные данные, в то время как авторизованные запросы могут также извлекать информацию о пользователе, прошедшем проверку подлинности в данный момент, или личные данные для него.

Поддерживаемые операции
список вставка обновление удалить
деятельность
заголовок
канал
Баннер канала
каналСекция
комментарий
комментарийThread
направляющаяКатегория
i18nLanguage
i18nRegion
плейлист
элемент списка воспроизведения
результат поиска
подписка
эскиз
видео
видеоКатегория
водяной знак

Использование квоты

API данных YouTube использует квоту, чтобы гарантировать, что разработчики используют службу по назначению и не создают приложения, которые несправедливо снижают качество службы или ограничивают доступ для других. Все запросы API, включая недействительные запросы, влекут за собой стоимость квоты не менее одного балла. Вы можете найти квоту, доступную для вашего приложения, в консоли API.

Для проектов, поддерживающих API данных YouTube, по умолчанию выделяется квота в 10 000 единиц в день, что достаточно для подавляющего большинства пользователей нашего API. Квота по умолчанию, которая может быть изменена, помогает нам оптимизировать распределение квот и масштабировать нашу инфраструктуру так, чтобы она была более значимой для пользователей нашего API. Вы можете увидеть использование своей квоты на странице «Квоты» в консоли API.

Примечание: Если вы достигли предела квоты, вы можете запросить дополнительную квоту,
завершение продления квоты
форма запроса на услуги YouTube API.

Расчет использования квоты

Google рассчитывает использование квоты, назначая стоимость для каждого запроса. Различные типы
операции имеют разную квотную стоимость. Например:

  • Операция чтения, которая извлекает список ресурсов — каналов, видео, плейлистов — обычно
    стоит 1 ед.
  • Операция записи, которая создает, обновляет или удаляет ресурс, обычно требует затрат
    50 шт.
  • Запрос на поиск стоит 100 ед.
  • Загрузка видео стоит 1600 единиц.

В таблице «Стоимость квоты для запросов API»
стоимость квоты для каждого метода API. Помня об этих правилах, вы можете оценить количество запросов
которые ваше приложение может отправлять в день, не превышая вашу квоту.

Частичные ресурсы

API позволяет и фактически требует извлечение частичных ресурсов, чтобы приложения избегали передачи, анализа и хранения ненужных данных. Такой подход также гарантирует, что API более эффективно использует ресурсы сети, ЦП и памяти.

API поддерживает два параметра запроса, которые объясняются в следующих разделах и позволяют определить свойства ресурсов, которые должны быть включены в ответы API.

  • Параметр часть определяет группы свойств, которые должны быть возвращены для ресурса.
  • Параметр fields фильтрует ответ API, чтобы возвращать только определенные свойства в запрошенных частях ресурсов.

Как использовать

, часть , параметр

Параметр , часть , является обязательным параметром для любого запроса API, который извлекает или возвращает ресурс. Параметр определяет одно или несколько свойств ресурсов верхнего уровня (невложенных), которые должны быть включены в ответ API. Например, ресурс видео состоит из следующих частей:

  • фрагмент
  • содержаниеДетали
  • файлДетали
  • игрок
  • обработкаДетали
  • записьДетали
  • статистика
  • статус
  • предложения
  • ТемаДетали

Все эти части являются объектами, которые содержат вложенные свойства, и вы можете думать об этих объектах как о группах полей метаданных, которые сервер API может (или не может) извлекать. Таким образом, параметр часть требует от вас выбора компонентов ресурсов, которые фактически использует ваше приложение. Это требование служит двум ключевым целям:

  • Уменьшает задержку, не позволяя серверу API тратить время на получение полей метаданных, которые не используются вашим приложением.
  • Уменьшает использование пропускной способности за счет уменьшения (или устранения) объема ненужных данных, которые может получить ваше приложение.

Со временем, когда ресурсы добавляют больше частей, эти преимущества будут только возрастать, поскольку ваше приложение не будет запрашивать новые введенные свойства, которые оно не поддерживает.

Как использовать

fields параметр

Параметр fields фильтрует ответ API, который содержит только части ресурсов, указанные в значении параметра part , так что ответ включает только определенный набор полей. Параметр fields позволяет удалить вложенные свойства из ответа API и тем самым еще больше сократить использование пропускной способности. (Параметр части нельзя использовать для фильтрации вложенных свойств из ответа.)

Следующие правила объясняют поддерживаемый синтаксис для fields значение параметра, основанное на синтаксисе XPath:

  • Используйте список, разделенный запятыми ( fields=a,b ), чтобы выбрать несколько полей.
  • Используйте звездочку ( fields=* ) в качестве подстановочного знака для обозначения всех полей.
  • Используйте круглые скобки ( fields=a(b,c) ), чтобы указать группу вложенных свойств, которые будут включены в ответ API.
  • Используйте косую черту ( fields=a/b ), чтобы указать вложенное свойство.

На практике эти правила часто позволяют нескольким различным значениям параметров полей получать один и тот же ответ API. Например, если вы хотите получить идентификатор элемента списка воспроизведения, название и позицию для каждого элемента в списке воспроизведения, вы можете использовать любое из следующих значений:

  • fields=items/id,playlistItems/snippet/title,playlistItems/snippet/position
  • fields=items(id,фрагмент/заголовок,фрагмент/позиция)
  • fields=items(id,snippet(title,position))

Примечание: Как и все значения параметра запроса, значение параметра fields должно быть закодировано в URL-адресе. Для лучшей удобочитаемости в примерах в этом документе кодировка не указана.

Примеры частичных запросов

В приведенных ниже примерах показано, как можно использовать параметры части и полей , чтобы гарантировать, что ответы API включают только те данные, которые использует ваше приложение:

  1. Пример 1 возвращает видеоресурс, который включает четыре части, а также свойства типа и etag .
  2. Пример 2 возвращает видеоресурс, который включает две части, а также свойства типа и etag .
  3. Пример 3 возвращает видеоресурс, который включает две части, но не включает свойства kind и etag .
  4. Пример 4 возвращает видеоресурс, который включает две части, но исключает типа и etag , а также некоторые вложенные свойства в объекте фрагмента ресурса .

Пример 1

  URL:  https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=  YOUR_API_KEY  
&part=snippet,contentDetails,statistics,status Описание: В этом примере извлекается ресурс видео и определяется несколько части ресурсов, которые должны быть включены в ответ API. Ответ API:

{ "вид": "youtube#videoListResponse", "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"", "видео": [ { "id": "7lCDEYXw3mM", "вид": "youtube#видео", "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"", "фрагмент": { "publishedAt": "2012-06-20T22:45:24.000Z", "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw", "title": "Google I/O 101: вопросы и ответы по использованию API Google", "description": "Антонио Фуэнтес говорит с нами и отвечает на вопросы по работе с Google API и OAuth 2.0.", "миниатюры": { "по умолчанию": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg" }, "середина": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg" }, "высокий": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg" } }, "categoryid": "28" }, "детали содержания": { "длительность": "ПТ15М51С", "соотношение сторон": "RATIO_16_9" }, "статистика": { "viewCount": "3057", "likeCount": "25", "dislikeCount": "0", "favoriteCount": "17", "Количество комментариев": "12" }, "положение дел": { "uploadStatus": "STATUS_PROCESSED", "privacyStatus": "PRIVACY_PUBLIC" } } ] }

Пример 2

  URL:  https://www. googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=  YOUR_API_KEY  
&part=snippet,statistics Описание: Этот пример изменяет часть значение параметра, чтобы contentDetails и статус свойства не включены в ответ. Ответ API:

{ "вид": "youtube#videoListResponse", "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"", "видео": [ { "id": "7lCDEYXw3mM", "вид": "youtube#видео", "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"", "фрагмент": { "publishedAt": "2012-06-20T22:45:24.000Z", "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ттв", "title": "Google I/O 101: вопросы и ответы по использованию API Google", "description": "Антонио Фуэнтес говорит с нами и отвечает на вопросы по работе с Google API и OAuth 2.0.", "миниатюры": { "по умолчанию": { "url": "https://i. ytimg.com/vi/7lCDEYXw3mM/default.jpg" }, "середина": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg" }, "высокий": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg" } }, "categoryid": "28" }, "статистика": { "viewCount": "3057", "likeCount": "25", "dislikeCount": "0", "favoriteCount": "17", "Количество комментариев": "12" } } ] }

Пример 3

  URL:  https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=  YOUR_API_KEY  
&part=snippet,statistics&fields=items(id,snippet,statistics) Описание: В этом примере добавляется параметр fields для удаления всех вида и etag свойства из ответа API. Ответ API:

{ "видео": [ { "id": "7lCDEYXw3mM", "фрагмент": { "publishedAt": "2012-06-20T22:45:24. 000Z", "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ттв", "title": "Google I/O 101: вопросы и ответы по использованию API Google", "description": "Антонио Фуэнтес говорит с нами и отвечает на вопросы по работе с Google API и OAuth 2.0.", "миниатюры": { "по умолчанию": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg" }, "середина": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg" }, "высокий": { "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg" } }, "categoryid": "28" }, "статистика": { "viewCount": "3057", "likeCount": "25", "dislikeCount": "0", "favoriteCount": "17", "Количество комментариев": "12" } } ] }

Пример 4

  URL:  https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=  YOUR_API_KEY  
&fields=items(id,snippet(channelId,title,categoryId),statistics)&part=snippet,statistics Описание: В этом примере изменяется параметр fields из примера 3. так что в ответе API фрагмент каждого видеоресурса объект включает только channelId , название , и свойств категории Id . Ответ API:

{ "видео": [ { "id": "7lCDEYXw3mM", "фрагмент": { "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw", "title": "Google I/O 101: вопросы и ответы по использованию API Google", "categoryid": "28" }, "статистика": { "viewCount": "3057", "likeCount": "25", "dislikeCount": "0", "favoriteCount": "17", "Количество комментариев": "12" } } ] }

Оптимизация производительности

Использование ETag

ETag, стандартная часть протокола HTTP, позволяют приложениям ссылаться на определенную версию определенного ресурса API. Ресурсом может быть весь фид или элемент в этом фиде. Эта функциональность поддерживает следующие варианты использования:

  • Кэширование и условный поиск — ваше приложение может кэшировать ресурсы API и их ETag. Затем, когда ваше приложение снова запрашивает сохраненный ресурс, оно указывает ETag, связанный с этим ресурсом. Если ресурс был изменен, API возвращает измененный ресурс и ETag, связанный с этой версией ресурса. Если ресурс не изменился, API возвращает ответ HTTP 304 ( Not Modified ), что указывает на то, что ресурс не изменился. Ваше приложение может уменьшить задержку и использование полосы пропускания, обслуживая таким образом кэшированные ресурсы.

    Клиентские библиотеки для API Google отличаются поддержкой ETag. Например, клиентская библиотека JavaScript поддерживает ETags через белый список разрешенных заголовков запросов, который включает If-Match и If-None-Match . Белый список позволяет выполнять обычное кэширование браузера, так что, если ETag ресурса не изменился, ресурс можно обслуживать из кэша браузера. С другой стороны, клиент Obj-C не поддерживает ETag.

  • Защита от непреднамеренной перезаписи изменений — теги ETag помогают предотвратить непреднамеренную перезапись изменений друг друга несколькими клиентами API. При обновлении или удалении ресурса ваше приложение может указать ETag ресурса. Если ETag не соответствует самой последней версии этого ресурса, запрос API завершается ошибкой.

Использование ETag в приложении дает несколько преимуществ:

  • API быстрее отвечает на запросы кэшированных, но неизмененных ресурсов, что обеспечивает меньшую задержку и меньшее использование полосы пропускания.
  • Ваше приложение не будет непреднамеренно перезаписывать изменения ресурса, сделанные другим клиентом API.

Клиентская библиотека API Google для JavaScript поддерживает заголовки HTTP-запросов If-Match и If-None-Match , что позволяет ETags работать в контексте обычного кэширования браузера.